Name

AskForExistingFile — Ask user for existing file

Synopsis

string AskForExistingFile ( string startWith ,
  string filter ,
  string headline );
 

Parameters

string startWith

is the initial directory or file.

string filter

is one or more blank-separated file patterns, e.g. "*.png *.jpg"

string headline

is an explanatory text for the file selection box. Graphical UIs may omit that if no window manager is running.

Return

string

Returns the selected file name or nil if the user canceled the operation.

Description

Opens a file selection box and prompt the user for an existing file.