Chapter Contents

Previous

Next
DLGOPEN

DLGOPEN



Opens the Open dialog box

OS/2 specifics: all


Syntax
Details
See Also

Syntax

DLGOPEN <LONGFILTER="filters" | FILTER=`filters' <REPLACE> ><SUBMIT | NOSUBMIT> <IMPORT> <VERIFY> <ALTCMD='command'>

no arguments
opens the Open 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 Open 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
dlgopen longfilter="*.Bob's work"
the dialog box displays all files in the current folder that have .Bob's work as their file extension.

Note:   When you are using the DLGOPEN 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 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

dlgopen 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="filters" and FILTER='filters' is the use of spaces and quotation marks. When you use LONGFILTER="filters", the filter can contain spaces and single quotation marks. When you use FILTER='filters' , the filters cannot contain spaces and quotes.   [cautionend]

SUBMIT | NOSUBMIT
specifies whether the Submit check box is checked when the dialog box opens. By default, the Submit check box (which indicates that the contents of the opened file should be immediately submitted as a SAS program) is not checked. To automatically submit a file it is opened, select Submit contents of file opened from the Preferences dialog box General page.

IMPORT
opens the Import dialog box, allowing you to import graphics files into your SAS session. For more information on importing graphics, see Importing a Graphics File from within a SAS/GRAPH Window.

VERIFY
verifies whether the active window contains a File pull-down menu with an Open item. If it does, the Open dialog box invokes the Open item command instead of invoking the default INCLUDE command.

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

ALTCMD='command'
specifies a command to be applied to the file that is selected form the Open dialog box. For example, the command
dlgopen altcmd='x' longfilter="*.bat"
allows you to select a DOS batch file, which is then run in a DOS shell. The INCLUDE command is the default command.


Details

The Open and Import dialog boxes allow you to select a file to read into the active window. To access the Open dialog box from the pull-down menus, select the File menu and then select Open. To access the Import dialog box from the pull-down menus, select the File menu and then select Import.

See Also


Chapter Contents

Previous

Next

Top of Page

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