[Overview][Constants][Types][Classes][Procedures and functions][Index] Reference for unit 'Masks' (#lazutils)

TMaskList.MatchesWindowsMask (deprecated)

Tests whether the file name matches a mask in the list using Windows file system masks.

Declaration

Source position: masks.pas line 334

public function TMaskList.MatchesWindowsMask(

  const AFileName: string

):Boolean;

Arguments

AFileName

  

File name examined in the method.

Function result

True if the file name matches one the masks in the list.

Description

MatchesWindowsMask is a Boolean function used to determined whether the specified file name matches a Windows-specific file mask found in the list.

MatchesWindowsMask creates a temporary TWindowsMaskList instance using the values in Mask, CaseSensitive, and MaskOpCodes. The value in DefaultWindowsQuirks is used to specify which Windows-specific file masks are enabled in the class instance. Its Matches method is called to compare the value in AFileName to the Windows-specific file masks.

The return value is True if the file name matches one of the Windows© file masks in the comparison.

MatchesWindowsMask is available, but should not be called, in the TWindowsMaskList descendant. This would result in an unnecessary allocation of a TWindowsMaskList instance. Use TWindowsMaskList and call its Matches method instead.

Use the Matches method to compare a file name using the mask semantics for the file system represented by the TMask or TWindowsMask used in the implementation.

Remark: MatchesWindowsMask is deprecated in LazUtils version 2.3, and will be removed in LazUtils version 2.5. Use the TWindowsMaskList class and call its Matches method instead.

See also

TMaskList.CaseSensitive

  

Indicates whether the Mask expressions in the list are case sensitive.

TMaskList.Mask

  

String with the delimited list of mask expressions for the class instances in the list.

TMaskList.MaskOpCodes

  

Contains the op codes allowed for the mask instances in the list.

TMaskList.Matches

  

Determines whether the specified file name matches a mask in the list.

TMaskList.GetMaskClass

  

Gets the class type used to create new mask instances for the list.

TMask

  

The TMask class represents a mask expression and performs comparisons.

TWindowsMask

  

Implements the class type used to evaluate and compare Windows-specific mask expressions.


Version 4.0 Generated 2025-05-03 Home