Chapter Contents

Previous

Next
DLGOPEN

DLGOPEN



Opens the Open dialog box

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 file names 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. When you use LONGFILTER="filters", the filters can contain spaces and single quotation marks. When you use FILTER='filters', the 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: combo 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 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 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 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.