Name

UI::AskForExistingFile — Open a file selection box and prompt the user for an 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

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