Difference between revisions of "GETFILE()"

From Recital Documentation Wiki
Jump to: navigation, search
 
(One intermediate revision by one user not shown)
Line 8: Line 8:
  
 
==See Also==
 
==See Also==
[[PUTFILE()]]
+
[[GETDIR()]], [[LOCFILE()]], [[PUTFILE()]]
  
  

Latest revision as of 10:44, 5 July 2011

Purpose

Function to display an Open dialog allowing a filename to be selected and returned.


Syntax

GETFILE([<expC1>] [,<expC2>] [,<expC3>] [,<expN1>])


See Also

GETDIR(), LOCFILE(), PUTFILE()


Description

The GETFILE() 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 GETFILE() function returns the name of that file. If no file is selected, the GETFILE() 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 = getfile("prg","Please select a program")


Products

Recital