Syntax


VIEW

[ file-name ]


[ .Profile-name ]


[ %imacro-name | %ON | %OFF | %NONE ]


[ /XForm-macro | /ON | /OFF | /NONE ]

       

Operands


file-name

The name of the file to be viewed. 


The filename may contain system variables ( %xxx% ) if desired, they will be substituted from the System variable settings.


If the file-name does not exist, VIEW will be cancelled.

.Profile-name

This optional operand allows you to specify an overriding Profile to be used for the View session. It simply consists of the name of the desired Profile, preceded by a . (period)

%imacro-name

This optional operand allows you to specify an IMACRO (a macro to be run immediately after the file is loaded). If an IMACRO is specified in the file's Profile, this imacro-name will override it.


You can use /OFF or /NONE to nullify an IMACRO specified in the Profile


You can use /ON to activate an IMACRO in the profile which is save in OFF mode.


See Profile IMACRO for details.

/XForm-macro

This optional operand allows you to specify an XFORM (a macro to allow access to non-standard file types). If an XFORM macro is specified in the file's Profile, this XForm-macro will override it.


You can use /OFF or /NONE to nullify an XFORM macro specified in the Profile


You can use /ON to activate an XFORM macro in the profile which is saved in OFF mode.


See Profile XFORM for details.

Abbreviations and Aliases


VIEW can also be spelled as V

 

Description


The VIEW command loads a file into the work space for browsing. If no file-name operand is specified, a standard Windows File Open Dialog will be presented for you to select a file. 


In VIEW mode, you cannot SAVE the file, nor will AUTOSAVE cause the file to be saved. If you have altered the data, and wish to save the altered copy, you can use the CREATE or SAVEAS commands to save the data under a different file name. 


Sometimes in View mode you may find that you have actually made changes (since it is SO similar to Edit) and then when you END the session, your changes were just thrown away. You can protect against this with the Options -> General setting for Warn on modified View file?  This will cause a prompt if you are closing a modified View session and give you a chance to save the data before exiting.


In addition, when you modify a View file, the word View in the left-hand Status Bar box will be displayed as View to remind you it has been modified.


If the current working Tab contains data, a new Tab will be opened to hold the View session; otherwise the current Tab will be used.


Default Directory


When no operand at all or only a simple unqualified filename is provided for the VIEW command, the default directory used for searching for the file or for the file open dialog's starting directory will be determined as follows:


    • If there is an active file being edited in the tab where the command is issued, then the Path for THAT active file is used as the default for the command. 


    • If there is NO active file (when the tab header displays (New) ) then the current displayed directory of File Manager will be used. 


Overriding Profile


When you wish to use a different Profile from the one indicated by the file's extension, simply  provide the alternate profile name, preceded by a period, on the command line. For example to View  MYSOURCE.BAS using the TXT profile the command would be


VIEW MYSOURCE.BAS .TXT


The use of the alternate profile is for the duration of this session only, it does not alter any permanent Profile processing.

Created with the Personal Edition of HelpNDoc: Easily share your documentation with the world through a beautiful website