IShellView::SelectItem

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
-
Header File
shlobj.h
Unicode
No
Platform Notes
None

[Now Supported on Windows NT]

Changes the selection state of one or more items within the shell view window.

HRESULT SelectItem(

LPCITEMIDLIST pidlItem,	// Points to item ID list
UINT uFlags	// Specifies the selection state
);

Parameters
pidlItem
Pointer to the item ID list. If this parameter is NULL and uFlags is SVSI_DESELECTOTHERS, all items should be deselected.

uFlags
Flag specifying what type of selection to apply. This parameter can be one of the following values:

Value	Meaning
SVSI_DESELECT	Deselect the specified item.
SVSI_DESELECTOTHERS	If pidlItem is NULL, deselect all items.
SVSI_EDIT	Put the pidlItem in edit mode.
SVSI_ENSUREVISIBLE	Ensure the item is displayed on the screen.
SVSI_FOCUSED	The item should be given the focus.
SVSI_SELECT	The item should be selected.

Return Values
Returns NOERROR if successful or an OLE-defined error value otherwise.

Remarks
This method is used to implement functionality in the Explorer.

Notes to Implementors
SelectItem is used to implement the File Target command of the shell shortcut property sheet.