TcxCustomShellListView.AbsolutePath Property

Specifies the path to a shell item being accessed.

Declaration

property AbsolutePath: string read; write;

Property Value

Type
string

Remarks

Use the AbsolutePath property to specify the path to the required shell item. Any folder path can be specified in two ways:

• as a full path, including a sequence of all folders required for accessing the required shell item from the shell root.

Example:

cxShellListView1.AbsolutePath := 'C:\Documents and Settings\Administrator\My Documents\My Pictures';

• as a relative path, providing access to shell items within the current folder.

Example:

cxShellListView1.AbsolutePath := 'My Pictures';

The AbsolutePath property allows a user to access both virtual and standard shell items. Note that virtual shell items have no analog on the hard disk. You need to specify one of the virtual shell item path prefixes before the virtual shell item’s name. The cxShellObjectInternalAbsoluteVirtualPathPrefix constant allows accessing the required shell item from any current folder. The cxShellObjectInternalRelativeVirtualPathPrefix constant allows accessing the required shell item from the Root folder. Examples of virtual shell items include:

• Network printers;

• Other networked computers;

• Control Panel applications;

• Recycle Bin.

Example of accessing the Recycle Bin shell item via the absolute and relative virtual path prefix:

cxShellListView1.AbsolutePath := cxShellObjectInternalAbsoluteVirtualPathPrefix + '\Recycle Bin';
cxShellListView1.AbsolutePath := cxShellObjectInternalRelativeVirtualPathPrefix + '\Recycle Bin';

During navigation through the folders, the AbsolutePath property stores the path to the currently accessed shell item.

Note

the AbsolutePath property must contain folder names only. Specifying the file name within the AbsolutePath property causes unpredictable results.