SftDirectory.FolderUsingIDL Property	Softel vdm, Inc.

Returns a SftDirectoryFolder object given a file/folder's absolute IDL.

Syntax       

	Get
		VB.NET	refFolderObj = object.get_FolderUsingIDL(ByVal absoluteIDL As String, ByVal FindOnly As Boolean)  As SftDirectoryFolder
		VB	Set refFolderObj = object.FolderUsingIDL(ByVal absoluteIDL As String, ByVal FindOnly As Boolean)  As SftDirectoryFolder
		C#.NET	SftDirectoryFolder refFolderObj = object.get_FolderUsingIDL(string absoluteIDL, bool FindOnly);
		VC++	ISftDirectoryFolder* refFolderObj = object->FolderUsingIDL[_bstr_t absoluteIDL][VARIANT_BOOL FindOnly]; ISftDirectoryFolder* refFolderObj = object->GetFolderUsingIDL(_bstr_t absoluteIDL, VARIANT_BOOL FindOnly);
		C	HRESULT object->get_FolderUsingIDL(BSTR absoluteIDL, VARIANT_BOOL FindOnly, ISftDirectoryFolder** refFolderObj);
		Delphi	refFolderObj := object.FolderUsingIDL[absoluteIDL : WideString; FindOnly : WordBool]  : ISftDirectoryFolder;

object

A SftDirectory object.

absoluteIDL

A string value representing an ITEMIDLIST structure describing the absolute item ID of the folder to retrieve.

FindOnly

Defines whether the folder is located or added to the control.

FindOnly	Description
True	The folder absoluteIDL is located within the presently loaded files and folders.  If the file/folder is not found, Nothing (NULL) is returned.
False	If the specified file/folder absoluteIDL is not already present in the list, it is added to the control and all its parent folders are expanded.  If the path is only partially valid, all valid initial folders are added and expanded.  If the specified path is already present (even if part of a collapsed parent folder), its refFolderObj reference is returned. Parent folders are not expanded.

refFolderObj

Returns a SftDirectoryFolder object given a file/folder's absolute IDL.

Comments

The FolderUsingIDL property returns a SftDirectoryFolder object given a file/folder's absolute IDL.

If the specified path described by absoluteIDL cannot be found, the return value is Nothing (NULL).

The root folder cannot be located using the FolderUsingIDL property.

ITEMIDLIST structures are typically used when communicating with the Windows Shell.  For detailed information about the ITEMIDLIST structure and its use, please see Microsoft's Windows documentation.

The Folder property can be used to retrieve a SftDirectoryFolder object given a path name.