Sign in Join
FPDoc Onlineexperiment

TCustomFileListBox.Mask property

Member of TCustomFileListBoxpublicIn unit FileCtrl

Contains the mask for files selected for the control.

Declaration

pascal
property Mask: string read FMask write SetMask;

Description

Mask should be filled with one or more file masks separated by semi-colons. For example: '*.pdf;*.svg' will show all files with the extensions pdf and svg. The default value for the property is '*' which is the generic mask meaning any file or directory. Do not use the Windows specific mask '*.*' to attempt to show all files, which is the behavior from Delphi. In the LCL version of the control '*.*' will require the file name to have an extension.

Allowed wildcards include '*.*' which means zero or more characters, and '?' which means exactly 1 character with any value. Other characters represent themselves with one important detail: The file matching algorithm is not case sensitive. So if you set '*.PDF' in the mask, then 'PostScript.pdf' will also be shown, even on Linux which is a case sensitive file system.

This property has exactly the same rules and behavior as the Mask property in TFilterComboBox.

Changing the value in Mask causes the UpdateFileList method to be called to reload the file information for the current Directory in the Items property.

See also

An experiment, built from Lazarus main 2dfa93c66e of 10-22-2026. Not the official Lazarus documentation.