Name=

From BR Wiki
Jump to: navigation, search

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.