Chapter Contents

Previous

Next
DLGSAVE

DLGSAVE



Opens the Save As dialog box

Windows specifics: all


Syntax
Details
See Also

Syntax

DLGSAVE <LONGFILTER="filters" | FILTER=`filters' <REPLACE>> <EXPORT> <NOPROMPT> <VERIFY> <ALTCMD='command'>

no arguments
opens the Save As dialog box with the default settings.

LONGFILTER="filters" | FILTER=`filters'
LONGFILTER="filters" specifies one or more file filters to use as search criteria for displaying files in the Save as dialog box. The first filter in the argument list is the default filter and is used as the search criteria. All of the filters in the argument list are added to the list of filters in the Files of type: combo box. To search for additional file types, you would select another filter from the Files of type: combo box.

You must enclose the filter in double quotation marks. Note that you can specify long filename extensions that include spaces and single quotes, and each filter that you specify must be separated by a vertical bar (|). For example, if you specify

dlgsave longfilter="*.text|*.Bob's work|*.**XX"
the dialog displays all files in the current folder that have .TEXT as their file extension, and the dialog box adds *.text, *.Bob's work, and *.**XX to the Files of type: combo box.

Note:   When you are using the DLSAVE command in the DM statement, do not use single quotation marks as part of a longfilter. The DM statement requires single quotation marks around the command it submits. A single quotation mark in the longfilter indicates to the DM statement the end of the command.  [cautionend]

FILTER='filters' specifies one or more file filters to use as search criteria for displaying files in the Open dialog box. The first filter in the argument list is the default filter and is used as the search criteria. All of the filters in the argument list are added to the list of filters in the Files of type: combo box. To search for additional file types, you would select another filter from the Files of type: combo box. You must enclose the filter list in quotation marks. Separate multiple lists with a space. For example, if you specify

dlgsave filter='*.bak *.txt'
the dialog box displays all files in the current folder that have a .BAK file extension, and the dialog adds both *.BAK and *.TXT to the Files of type: combo box.

Note:   The difference between LONGFILTER="filters" and FILTER='filters' is that with LONGFILTER="filters" you can use spaces and quotes in the filters, where in FILTER='filters' you cannot use spaces and quotes.  [cautionend]

REPLACE
replaces the filter list with the specified filters instead of concatenating the list with the default filters. This option is valid only when you specify the LONGFILTER= or FILTER= arguments as well. For example, the command
dlgsave longfilter="*.txt" replace
will load the Files of type: combo box with only the *.TXT specification (instead of the default file types).

EXPORT
invokes the Export dialog box, allowing you to export graphics files from your SAS session. For more information about the Export dialog box, see Exporting Graphics for Use with Other Applications.

NOPROMPT
does not prompt the user to replace or append an existing file.

VERIFY
verifies whether the active window contains a File pull-down menu with a Save item. If it does, the Save As dialog box invokes the Save item instead of the default FILE command.

The VERIFY argument is not valid when specified with ALTCMD or EXPORT.

ALTCMD='command'
specifies the command to be applied to the file that is selected from the Save As dialog box. For example, the command
dlgsave altcmd='prtfile'
sets the file selected from the Save As dialog box as the current print file. The FILE command is the default command.


Details

The Save As dialog box lets you save the contents of the active window to a file. To access the Save As dialog box from the pull-down menus, select the File menu and then select Save As.

See Also


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.