Difference between revisions of "PUTFILE()"
From Lianjapedia
Helen.george (Talk | contribs) |
|||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
==Purpose== | ==Purpose== | ||
Function to display a Save As dialog allowing a filename to be selected or specified and returned. | Function to display a Save As dialog allowing a filename to be selected or specified and returned. | ||
| − | |||
==Syntax== | ==Syntax== | ||
PUTFILE([<expC1>] [,<expC2>] [,<expC3>]) | PUTFILE([<expC1>] [,<expC2>] [,<expC3>]) | ||
| − | |||
==See Also== | ==See Also== | ||
[[GETFILE()]] | [[GETFILE()]] | ||
| − | |||
==Description== | ==Description== | ||
The PUTFILE() function displays a Save As dialog allowing a filename to be selected or specified 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 Screen Forms. If the user selects or specifies a file, the PUTFILE() function returns the name of that file. If no file is selected or specified, the PUTFILE() function returns an empty string "". | The PUTFILE() function displays a Save As dialog allowing a filename to be selected or specified 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 Screen Forms. If the user selects or specifies a file, the PUTFILE() function returns the name of that file. If no file is selected or specified, the PUTFILE() function returns an empty string "". | ||
| − | + | {| class="wikitable" width="100%" | |
| − | {| class="wikitable" | + | !width="20%"|Parameters||width="20%"|Required||Description |
| − | !Parameters||Required||Description | + | |
|- | |- | ||
| − | |<expC1>||No||The text to display at the top of the dialog. If not specified, 'Save As' is displayed. | + | |valign="top"|<expC1>||No||The text to display at the top of the dialog. If not specified, 'Save As' is displayed. |
|- | |- | ||
| − | |<expC2>||No||The default filename displayed in the text entry area.. | + | |valign="top"|<expC2>||No||The default filename displayed in the text entry area.. |
|- | |- | ||
| − | |<expC3>||No||A file extension skeleton. If specified only files with this extension are shown. | + | |valign="top"|<expC3>||No||A file extension skeleton. If specified only files with this extension are shown. |
|- | |- | ||
|} | |} | ||
| − | |||
| − | |||
==Example== | ==Example== | ||
| Line 32: | Line 26: | ||
cProgramSaveAs = putfile("Save the program","default.prg","prg") | cProgramSaveAs = putfile("Save the program","default.prg","prg") | ||
</code> | </code> | ||
| − | |||
==Products== | ==Products== | ||
| − | + | Lianja | |
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
[[Category:UI_Functions]] | [[Category:UI_Functions]] | ||
Latest revision as of 13:00, 1 February 2013
Purpose
Function to display a Save As dialog allowing a filename to be selected or specified and returned.
Syntax
PUTFILE([<expC1>] [,<expC2>] [,<expC3>])
See Also
Description
The PUTFILE() function displays a Save As dialog allowing a filename to be selected or specified 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 Screen Forms. If the user selects or specifies a file, the PUTFILE() function returns the name of that file. If no file is selected or specified, the PUTFILE() function returns an empty string "".
| Parameters | Required | Description |
|---|---|---|
| <expC1> | No | The text to display at the top of the dialog. If not specified, 'Save As' is displayed. |
| <expC2> | No | The default filename displayed in the text entry area.. |
| <expC3> | No | A file extension skeleton. If specified only files with this extension are shown. |
Example
cProgramSaveAs = putfile("Save the program","default.prg","prg")
Products
Lianja
