Chapter Contents

Previous

Next
DLGSAVE

DLGSAVE



Opens the Save As dialog box

OS/2 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 used as the search criteria. You must enclose the filter list in double quotation marks. Note that you can specify long file names that include spaces and single quotes. For example, if you specify
dlgsave longfilter="*.Bob's work"
the Save As dialog box displays all files in the current folder that have .Bob's work as their file extension.

Note:   When you are using the DLGSAVE 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 Save As dialog box. The first filter in the list is used as the search criteria. You must enclose the filter list in quotation marks. Separate multiple filters 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 and .TXT file extensions.

In both LONGFILTER= and FILTER= you can specify one or more filters but only the first filter is honored.

Note:   The difference between LONGFILTER="filter" 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]

EXPORT
opens 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 the ALTCMD or EXPORT arguments.

ALTCMD='command'
specifies a 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.