GETPICT( ) Function

See Also

Displays the Open Picture dialog box and returns the name of the picture file you chose.

Syntax

GETPICT([cFileExtensions] [, cFileNameCaption] [, cOpenButtonCaption])

Returns

Character

Arguments

cFileExtensions

Specifies the file extensions of the picture files displayed in the scrollable list when the All Files menu item isn't chosen.

cFileExtensions can take the following forms:

• If cFileExtensions contains a single extension (for example, .bmp), only files with that extension are displayed.
  
  
• cFileExtensions can also contain wildcards (* and ?). All files with extensions that meet the wildcard criteria are displayed. For example, if cFileExtensions is ?X?, all files with the extension .fxp, .exe, and .txt are displayed.
  
  
• If cFileExtensions contains an empty string (""), files with the extensions .bmp and .dib are displayed.

cFileNameCaption

Specifies the caption displayed above the File Name text box. cFileNameCaption replaces "File Name" that appears when cFileNameCaption is omitted.

cOpenButtonCaption

Specifies a caption for the OK button.

Remarks

GETPICT( ) returns the empty string if you exit the Open Picture dialog box by pressing ESC, choosing the Cancel button, or clicking the Close button.