TImageEnMView.FilterField

Declaration

property FilterField: TIEImageEnMViewSortBy;

Description

Specifies the filter to compare when filtering images by the current Filter.
Filtering is disabled if FilterField = iesbNone.

Note:
◼When filtering is active the filtered frames are hidden from display but still available programmatically
◼For more control over filtering use OnFilter
◼FilterField has no effect if Filter is prefixed by # (which is for index filtering)

Text filtering is formatted as follows:

Value	Description
TEXT (or just TEXT)	Matches strings containing "text"
TEXT*	Matches strings that start with "text"
*TEXT	Matches strings that end with "text"
"TEXT"	Matches strings that are an exact match with "text"

Text Filtering Notes:
◼Filtering is case-insensitive
◼Folders are not filtered (use index filtering or OnFilter instead)
◼Only the filename and its extension is assessed, not the path

Index filtering is formatted as follows:

Value	Description
#0,2,5	Show thumbs 0, 2 and 5
#5-7	Show thumbs 5, 6 and 7
#10+	Show thumbs 10 and higher
#0,2,6-7,10+	Show thumbs 0, 2, 6, 7, 10, 11, 12, etc.

Index Filtering Notes:
◼Index filters must be prefixed by #
◼Index values are zero-based, e.g. #0 shows only the first frame, #1 shows only the second frame
◼Index values do NOT need to be ordered or exclusive, e.g. "#1-5, 3, 1" is acceptable

Data and number filtering is formatted as follows:

Value	Description
>100	Value is greater than 100
>=100	Value is >= 100
=100	Value is equal to 100
<=100	Value is <= filter
<100	Value is less than filter

Data and Number Filtering Notes:
◼Only supported by fields: iesbImageSize, iesbFileSize, iesbCreateDate, iesbEditDate
◼iesbImageSize valyes are specified as W x H, e.g. >1000000 means more than one megapixel
◼iesbFileSize values are specified as bytes, e.g. <1024 means less one KB
◼iesbCreateDate and iesbEditDate values are specified as simple dates, e.g using DateToStr(), e.g. on a US system >=12/25/2022 would mean on or after Christmas 2022

Demo

Demos\Multi\Filtering\Filtering.dpr

Example

// Display files that start with "Image"
IEFolderMView1.Filter := 'image*';

// Display files containing "Italy" anywhere in Info text
IEFolderMView1.FilterField := iesbInfoText;
IEFolderMView1.Filter := '*italy*';

// Display any files ending in 2015
IEFolderMView1.Filter := '*2015.*';

// Display PNG files ending in 2015
IEFolderMView1.Filter := '*2015.png';

// Display PNG files
IEFolderMView1.Filter := '*.png';

// Alternatively...
IEFolderMView1.FilterField := iesbFileExtension;
IEFolderMView1.Filter := '"png"';

// Display file of index 1 (Second thumbnail)
IEFolderMView1.Filter := '#1';

// Display files containing text #1
IEFolderMView1.Filter := '*#1*';

// Display file of index 0, 2, 6, 7, 10, 11, 15, 16, 17...
IEFolderMView1.Filter := '#0,2,6-7,10-11,15+';

// Display images greater than 10 mega-pixels
IEFolderMView1.FilterField := iesbImageSize;
IEFolderMView1.Filter      := '>' + IntToStr( 10*1000*1000 );

// Display images smaller than 1KB
IEFolderMView1.FilterField := iesbFileSize;
IEFolderMView1.Filter      := '<' + IntToStr( 1024 );

// Return images modified in the last week
IEFolderMView1.FilterField := iesbEditDate;
IEFolderMView1.Filter      := '<=' + DateToStr( Now - 7 );

// Clear the filter (show all files)
IEFolderMView1.Filter := '';

TImageEnMView.FilterField