SftDirectory.MatchFolder Property	Softel vdm, Inc.

Defines the wildcard pattern a folder name has to match in order to be added to the control.

Syntax       

	Get
		VB.NET	String = object.MatchFolder  As String
		VB	String = object.MatchFolder  As String
		C#.NET	string String = object.MatchFolder;
		VC++	_bstr_t String = object->MatchFolder; _bstr_t String = object->GetMatchFolder();
		C	HRESULT object->get_MatchFolder(BSTR* String);
		Delphi	String := object.MatchFolder   : WideString;
	Put
		VB.NET	object.MatchFolder = String  As String
		VB	object.MatchFolder = String  As String
		C#.NET	string object.MatchFolder = String;
		VC++	_bstr_t object->MatchFolder = String; void object->PutMatchFolder(_bstr_t String);
		C	HRESULT object->put_MatchFolder(BSTR String);
		Delphi	object.MatchFolder := String   : WideString;

object

A SftDirectory object.

String

Defines the wildcard pattern a folder name has to match in order to be added to the control. Set to an empty string to clear.

Comments

The MatchFolder property defines the wildcard pattern a folder name has to match in order to be added to the control.

Folders that are part of the file system (SftDirectoryFolder.IsFolder is True) must match the wildcard pattern defined using the MatchFolder or MatchFolderRegexp properties to be displayed by the SftDirectory control. Files, links, etc. are not tested against the defined pattern. Files that are part of the file system must match the wildcard pattern defined using the MatchFile or MatchFileRegexp properties.

The MatchFolderRegexp property is identical to the MatchFolder property, but supports Perl regular expressions instead of a wildcard pattern. If the MatchFolder property defines a pattern, the MatchFolderRegexp property is ignored.

If the MatchFolder and MatchFolderRegexp properties are empty (empty string), all folders are displayed by the SftDirectory control.

The MatchFolder property accepts simple DOS-style wildcard patterns, where '?' matches any one character, '*' matches any number of characters, any other characters in the pattern must match the filename exactly.

Examples:

*.* matches all folders

*.archive matches all folders with the extension "archive".

A?0* matches all folders with the letter A in the first position and the number 0 in the third position.