Difference between revisions of "GETDIR()"
From Lianjapedia
Helen.george (Talk | contribs) |
|||
Line 11: | Line 11: | ||
The GETDIR() function displays an Open dialog allowing a filename to be selected and returned. The dialog allows navigation through directories and shows a list of relevant files in that directory. The cursor keys, Return key and tab key can be used to navigate the different sections under a character mode environment. If the user selects a file, the GETDIR() function returns the name of that file. If no file is selected, the GETDIR() function returns an empty string "". | The GETDIR() function displays an Open dialog allowing a filename to be selected and returned. The dialog allows navigation through directories and shows a list of relevant files in that directory. The cursor keys, Return key and tab key can be used to navigate the different sections under a character mode environment. If the user selects a file, the GETDIR() function returns the name of that file. If no file is selected, the GETDIR() function returns an empty string "". | ||
− | {| class="wikitable" | + | {| class="wikitable" width=100% |
− | !Parameters||Required||Description | + | !width=30%|Parameters||width=20%|Required||Description |
|- | |- | ||
− | |<expC1>||No||A file extension skeleton. If specified only files with this extension are shown | + | |valign="top"|<expC1>||valign="top"|No||A file extension skeleton. If specified only files with this extension are shown |
|- | |- | ||
− | |<expC2>||No||The text to display at the top of the dialog. If not specified, 'Open' is displayed. | + | |valign="top"|<expC2>||valign="top"|No||The text to display at the top of the dialog. If not specified, 'Open' is displayed. |
|- | |- | ||
− | |<expC3>||No||The text to display on the Ok button. This is ignored, the button is always labeled 'Ok'. | + | |valign="top"|<expC3>||valign="top"|No||The text to display on the Ok button. This is ignored, the button is always labeled 'Ok'. |
|- | |- | ||
− | |<expN1>||No||The buttons set to be displayed. This is ignored, the buttons are always Ok, Cancel, Reset, Back and Help. | + | |valign="top"|<expN1>||valign="top|No||The buttons set to be displayed. This is ignored, the buttons are always Ok, Cancel, Reset, Back and Help. |
|- | |- | ||
|} | |} |
Revision as of 11:18, 22 January 2013
Contents
Purpose
Function to display an Open dialog allowing a filename to be selected and returned.
Syntax
GETDIR([<expC1>] [,<expC2>] [,<expC3>] [,<expN1>])
See Also
DIRECTORY(), GETFILE(), LOCFILE(), PUTFILE()
Description
The GETDIR() function displays an Open dialog allowing a filename to be selected and returned. The dialog allows navigation through directories and shows a list of relevant files in that directory. The cursor keys, Return key and tab key can be used to navigate the different sections under a character mode environment. If the user selects a file, the GETDIR() function returns the name of that file. If no file is selected, the GETDIR() function returns an empty string "".
Parameters | Required | Description |
---|---|---|
<expC1> | No | A file extension skeleton. If specified only files with this extension are shown |
<expC2> | No | The text to display at the top of the dialog. If not specified, 'Open' is displayed. |
<expC3> | No | The text to display on the Ok button. This is ignored, the button is always labeled 'Ok'. |
<expN1> | No | The buttons set to be displayed. This is ignored, the buttons are always Ok, Cancel, Reset, Back and Help. |
Example
cProgramSelected = getdir("prg","Please select a program")