SAS Commands under Windows

DLGOPEN Command: Windows

Opens the Open dialog box for the default editor.

Windows 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 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 double quotation marks. Note that you can specify long filenames that include spaces and single quotes. Separate each filter that you specify with a vertical bar (|). For example, if you specify

dlgopen longfilter="*.text|*.Bob's work|*.*XX"

the dialog box 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 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 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 quotation marks. Separate multiple lists 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 file extension, and adds both *.BAK and *.TXT to the Files of Type: combo box.

Note: The difference between LONGFILTER="filters" and FILTER='filters' is the use of spaces and quotation marks. Use LONGFILTER="filters" if filters contain spaces and single quotation marks. If you use FILTER='filters', filters cannot contain spaces and single quotation marks. [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= argument as well. For example, the command

dlgopen longfilter="*.txt" replace

will load the Files of type: box with the *.TXT specification (instead of the default file types).

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 when it is opened, select Submit contents of file opened from the Preferences dialog box General page.

IMPORT

invokes 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 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 from 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 dialog box enables you to open files in the default editor. The default editor is determined from the Use Enhanced Editor option on the Preferences dialog box Edit tabbed page. If this option is selected, the Enhanced Editor is the default editor. Otherwise, the Program Editor is the default editor.

To access the Open dialog box from the menus, select the File menu and then select Open.