View source for Name=

Name= can be used with OPEN, SAVE, or REPLACE. 

====Using a File Selection Box With REPLACE====

(4.2) The file browser dialog box syntax has been expanded to include "NAME=REPLACE: starting-directory[mask]" which denotes the same as NAME=SAVE:... except no confirmation dialog will be given if the user selects an existing file. When SAVE is specified and the user selects an existing file a confirmation dialog will always be presented.

NAME=OPEN, NAME=SAVE and NAME=REPLACE all do the same thing except that the dialog is captioned “OPEN” for NAME=OPEN, and it is captioned “SAVE” for NAME=SAVE and NAME=REPLACE.

Any of NAME=OPEN | SAVE | REPLACE:... specifications may be given in conjunction with any of the OUTPUT file parameters NEW | USE | REPLACE. However certain combinations are most commonly used:

====INPUT Processing====

*   NAME=OPEN:.. used for INPUT processing, where NEW/USE/REPLACE is not applicable

====OUTPUT Processing====
*   NAME=SAVE:...NEW	If existing file is selected then Error 4150. If a new file is specified create it.

*   NAME=SAVE:...USE	If an existing file is selected, append to it. If a new file is specified create it.

*   NAME=SAVE:...REPLACE If an existing file is selected, confirm first and then replace it. If a new file is specified, create it.

*   NAME=REPLACE:...REPLACE If an existing file is selected, replace it. If a new file is specified create it.

The REPLACE keyword in the NAME= parameter only qualifies the open dialog 
and the REPLACE keyword in the OPEN string continues to overwrite if pre-existing. In other words if you use NAME=REPLACE: then you should also specify REPLACE elsewhere in the OPEN string.

<noinclude>
[[Category:Definitions]]
</noinclude>