_SVSIF enumeration (shobjidl_core.h)
Indicates flags used by IFolderView, IFolderView2, IShellView and IShellView2 to specify a type of selection to apply.
Syntax
typedef enum _SVSIF {
SVSI_DESELECT = 0,
SVSI_SELECT = 0x1,
SVSI_EDIT = 0x3,
SVSI_DESELECTOTHERS = 0x4,
SVSI_ENSUREVISIBLE = 0x8,
SVSI_FOCUSED = 0x10,
SVSI_TRANSLATEPT = 0x20,
SVSI_SELECTIONMARK = 0x40,
SVSI_POSITIONITEM = 0x80,
SVSI_CHECK = 0x100,
SVSI_CHECK2 = 0x200,
SVSI_KEYBOARDSELECT = 0x401,
SVSI_NOTAKEFOCUS = 0x40000000
} ;
Constants
SVSI_DESELECT Value: 0 0x00000000. Deselect the item. |
SVSI_SELECT Value: 0x1 0x00000001. Select the item. |
SVSI_EDIT Value: 0x3 0x00000003. Put the name of the item into rename mode. This value includes SVSI_SELECT. |
SVSI_DESELECTOTHERS Value: 0x4 0x00000004. Deselect all but the selected item. If the item parameter is NULL, deselect all items. |
SVSI_ENSUREVISIBLE Value: 0x8 0x00000008. In the case of a folder that cannot display all of its contents on one screen, display the portion that contains the selected item. |
SVSI_FOCUSED Value: 0x10 0x00000010. Give the selected item the focus when multiple items are selected, placing the item first in any list of the collection returned by a method. |
SVSI_TRANSLATEPT Value: 0x20 0x00000020. Convert the input point from screen coordinates to the list-view client coordinates. |
SVSI_SELECTIONMARK Value: 0x40 0x00000040. Mark the item so that it can be queried using IFolderView::GetSelectionMarkedItem. |
SVSI_POSITIONITEM Value: 0x80 0x00000080. Allows the window's default view to position the item. In most cases, this will place the item in the first available position. However, if the call comes during the processing of a mouse-positioned context menu, the position of the context menu is used to position the item. |
SVSI_CHECK Value: 0x100 0x00000100. The item should be checked. This flag is used with items in views where the checked mode is supported. |
SVSI_CHECK2 Value: 0x200 0x00000200. The second check state when the view is in tri-check mode, in which there are three values for the checked state. You can indicate tri-check mode by specifying FWF_TRICHECKSELECT in IFolderView2::SetCurrentFolderFlags. The 3 states for FWF_TRICHECKSELECT are unchecked, SVSI_CHECK and SVSI_CHECK2. |
SVSI_KEYBOARDSELECT Value: 0x401 0x00000401. Selects the item and marks it as selected by the keyboard. This value includes SVSI_SELECT. |
SVSI_NOTAKEFOCUS Value: 0x40000000 0x40000000. An operation to select or focus an item should not also set focus on the view itself. |
Remarks
An additional value SVSI_NOSTATECHANGE is also defined outside of the enumeration. This value indicates that an operation to edit or position an item should not affect the item's focus or selected state. Its numeric value is (UINT)0x80000000.
The SVSIF type used to refer to members of the _SVSIF enumeration is defined in Shobjidl.h as shown here.
typedef UINT SVSIF;
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Header | shobjidl_core.h (include Shobjidl.h) |