Difference between revisions of "GETDIR()"
From Lianjapedia
Helen.george (Talk | contribs) |
Yvonne.milne (Talk | contribs) |
||
Line 1: | Line 1: | ||
==Purpose== | ==Purpose== | ||
− | Function to display | + | Function to display a dialog allowing a directory to be selected and its name returned. |
==Syntax== | ==Syntax== | ||
− | GETDIR([<expC1> | + | GETDIR([<expC1> [, <expC2> [, <expC3> [, <expN> [, <expL>]]]]]) |
==See Also== | ==See Also== | ||
Line 9: | Line 9: | ||
==Description== | ==Description== | ||
− | The GETDIR() function displays | + | The GETDIR() function displays a dialog allowing a directory to be selected and its name returned. The dialog allows navigation through directories and sub-directories. If a directory is selected, the GETDIR() function returns the name of that directory. If no directory is selected, the GETDIR() function returns an empty string "". |
{| class="wikitable" width="100%" | {| class="wikitable" width="100%" | ||
− | !width="30%"|Parameters||width=20% | + | !width="30%"|Parameters||width=20%||Description |
|- | |- | ||
− | |valign="top"|<expC1>||valign="top"| | + | |valign="top"|<expC1>||valign="top"||The starting directory |
|- | |- | ||
− | |valign="top"|<expC2>||valign="top"| | + | |valign="top"|<expC2>||valign="top"||Ignored. |
|- | |- | ||
− | |valign="top"|<expC3>||valign="top" | + | |valign="top"|<expC3>||valign="top"||The text to display in the dialog title bar. |
|- | |- | ||
− | |valign="top"|< | + | |valign="top"|<expN>||valign="top||Ignored. |
+ | |- | ||
+ | |valign="top"|<expL>||valign="top||Ignored. | ||
|- | |- | ||
|} | |} | ||
Line 26: | Line 28: | ||
==Example== | ==Example== | ||
<code lang="recital"> | <code lang="recital"> | ||
− | + | cDirSelected = getdir("C:\Lianja","","Please select a directory") | |
</code> | </code> | ||
Revision as of 12:54, 19 May 2014
Contents
Purpose
Function to display a dialog allowing a directory to be selected and its name returned.
Syntax
GETDIR([<expC1> [, <expC2> [, <expC3> [, <expN> [, <expL>]]]]])
See Also
DIRECTORY(), GETFILE(), LOCFILE(), PUTFILE()
Description
The GETDIR() function displays a dialog allowing a directory to be selected and its name returned. The dialog allows navigation through directories and sub-directories. If a directory is selected, the GETDIR() function returns the name of that directory. If no directory is selected, the GETDIR() function returns an empty string "".
Parameters | width=20% | Description |
---|---|---|
<expC1> | valign="top" | The starting directory |
<expC2> | valign="top" | Ignored. |
<expC3> | valign="top" | The text to display in the dialog title bar. |
<expN> | valign="top | Ignored. |
<expL> | valign="top | Ignored. |
Example
cDirSelected = getdir("C:\Lianja","","Please select a directory")