IExplorerListView Interface Reference

The main interface More...

List of all members.

Public Member Functions
HRESULT	About (void)
	Displays the control's credits
HRESULT	ApproximateViewRectangle ([in, defaultvalue(-1)] LONG numberOfItems,[in, out, defaultvalue(0)] OLE_XSIZE_PIXELS *proposedWidth,[in, out, defaultvalue(0)] OLE_YSIZE_PIXELS *proposedHeight)
	Approximates the listview's optimal size
HRESULT	ArrangeItems ([in, defaultvalue(astDefault)] ArrangementStyleConstants arrangementStyle)
	Arranges the listview's items
HRESULT	BeginDrag ([in] IListViewItemContainer *draggedItems,[in, defaultvalue(0)] OLE_HANDLE hDragImageList,[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *xHotSpot,[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *yHotSpot)
	Enters drag'n'drop mode
HRESULT	CountVisible ([out, retval] LONG *pValue)
	Calculates the maximum number of entirely visible items within the listview
HRESULT	CreateItemContainer ([in, optional] VARIANT items,[out, retval] IListViewItemContainer **ppContainer)
	Creates a new ListViewItemContainer object
HRESULT	EndDrag ([in] VARIANT_BOOL abort)
	Exits drag'n'drop mode
HRESULT	EndLabelEdit ([in] VARIANT_BOOL discard)
	Ends label-editing
HRESULT	FindItem ([in] SearchModeConstants searchMode,[in] VARIANT searchFor,[in, defaultvalue(sdNoneSpecific)] SearchDirectionConstants searchDirection,[in, defaultvalue(-1)] VARIANT_BOOL wrapAtLastItem,[out, retval] IListViewItem **ppFoundItem)
	Finds an item with the specified characteristics
HRESULT	GetClosestInsertMarkPosition ([in] OLE_XPOS_PIXELS x,[in] OLE_YPOS_PIXELS y,[in, out] InsertMarkPositionConstants *relativePosition,[in, out] IListViewItem **listItem)
	Proposes a position for the control's insertion mark
HRESULT	GetFooterRectangle ([in, out, defaultvalue(0)] OLE_XPOS_PIXELS *xLeft,[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *yTop,[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *xRight,[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *yBottom)
	Retrieves the bounding rectangle of the control's footer area
HRESULT	GetHeaderChevronRectangle ([in, out, defaultvalue(0)] OLE_XPOS_PIXELS *Left,[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *Top,[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *Right,[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *Bottom)
	Retrieves the bounding rectangle of the column header's chevron button
HRESULT	GetIconSpacing ([in] ViewConstants viewMode,[in, out, defaultvalue(0)] OLE_XSIZE_PIXELS *itemWidth,[in, out, defaultvalue(0)] OLE_YSIZE_PIXELS *itemHeight)
	Determines the spacing between items in 'Icons' or 'Small Icons' view
HRESULT	GetInsertMarkPosition ([in, out] InsertMarkPositionConstants *relativePosition,[in, out] IListViewItem **listItem)
	Retrieves the position of the control's insertion mark
HRESULT	GetInsertMarkRectangle ([in, out, defaultvalue(0)] OLE_XPOS_PIXELS *xLeft,[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *yTop,[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *xRight,[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *yBottom)
	Retrieves the bounding rectangle of the control's insertion mark
HRESULT	GetOrigin ([in, out, defaultvalue(0)] OLE_XPOS_PIXELS *x,[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *y)
	Retrieves the control's current view origin
HRESULT	GetStringWidth ([in] BSTR stringToTest,[out, retval] OLE_XSIZE_PIXELS *pWidth)
	Determines the width of the specified string using the control's current font
HRESULT	GetViewRectangle ([in, out, defaultvalue(0)] OLE_XPOS_PIXELS *xLeft,[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *yTop,[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *xRight,[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *yBottom)
	Retrieves the bounding rectangle of all items in the control
HRESULT	HeaderBeginDrag ([in] IListViewColumn *draggedColumn,[in, defaultvalue(0)] OLE_HANDLE hDragImageList,[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *xHotSpot,[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *yHotSpot,[in, defaultvalue(-1)] VARIANT_BOOL restrictDragImage)
	Enters drag'n'drop mode
HRESULT	HeaderEndDrag ([in] VARIANT_BOOL abort)
	Exits drag'n'drop mode
HRESULT	HeaderHitTest ([in] OLE_XPOS_PIXELS x,[in] OLE_YPOS_PIXELS y,[in, out] HeaderHitTestConstants *hitTestDetails,[out, retval] IListViewColumn **ppHitColumn)
	Hit-tests the specified point
HRESULT	HeaderOLEDrag ([in, defaultvalue(NULL)] LONG *pDataObject,[in, defaultvalue(odeCopyOrMove)] OLEDropEffectConstants supportedEffects,[in, defaultvalue(-1)] OLE_HANDLE hWndToAskForDragImage,[in, defaultvalue(NULL)] IListViewColumn *draggedColumnHeader,[in, defaultvalue(-1)] LONG itemCountToDisplay,[out, retval] OLEDropEffectConstants *pPerformedEffects)
	Enters OLE drag'n'drop mode
HRESULT	HeaderRefresh (void)
	Advises the header control to redraw itself
HRESULT	HitTest ([in] OLE_XPOS_PIXELS x,[in] OLE_YPOS_PIXELS y,[in, out] HitTestConstants *hitTestDetails,[in, out, optional] VARIANT *hitSubItem,[in, out, optional] VARIANT *hitGroup,[in, out, optional] VARIANT *hitFooterItem,[out, retval] IListViewItem **ppHitItem)
	Hit-tests the specified point
HRESULT	IsFooterVisible ([out, retval] VARIANT_BOOL *pVisible)
	Retrieves whether the footer area is currently displayed
HRESULT	LoadSettingsFromFile ([in] BSTR file,[out, retval] VARIANT_BOOL *pSucceeded)
	Loads the control's settings from the specified file
HRESULT	OLEDrag ([in, defaultvalue(NULL)] LONG *pDataObject,[in, defaultvalue(odeCopyOrMove)] OLEDropEffectConstants supportedEffects,[in, defaultvalue(-1)] OLE_HANDLE hWndToAskForDragImage,[in, defaultvalue(NULL)] IListViewItemContainer *draggedItems,[in, defaultvalue(-1)] LONG itemCountToDisplay,[out, retval] OLEDropEffectConstants *pPerformedEffects)
	Enters OLE drag'n'drop mode
HRESULT	RedrawItems ([in, defaultvalue(0)] LONG iFirstItem,[in, defaultvalue(-1)] LONG iLastItem)
	Redraws a range of items
HRESULT	Refresh (void)
	Advises the control to redraw itself
HRESULT	SaveSettingsToFile ([in] BSTR file,[out, retval] VARIANT_BOOL *pSucceeded)
	Saves the control's settings to the specified file
HRESULT	Scroll ([in] OLE_XSIZE_PIXELS horizontalDistance,[in] OLE_YSIZE_PIXELS verticalDistance)
	Scrolls the control's content
HRESULT	SetFocusToHeader (void)
	Sets the keyboard focus to the header control
HRESULT	SetHeaderInsertMarkPosition ([in, defaultvalue(0)] LONG position,[in, defaultvalue(0x80000000)] LONG x,[in, defaultvalue(0x80000000)] LONG y,[out, retval] LONG *pPosition)
	Sets the position of the header control's insertion mark
HRESULT	SetIconSpacing ([in] OLE_XSIZE_PIXELS itemWidth,[in] OLE_YSIZE_PIXELS itemHeight)
	Sets the spacing between items in 'Icons' view
HRESULT	SetInsertMarkPosition ([in] InsertMarkPositionConstants relativePosition,[in] IListViewItem *listItem)
	Sets the position of the control's insertion mark
HRESULT	ShowFooter (void)
	Displays the footer area
HRESULT	SortGroups ([in, defaultvalue(sobShell)] SortByConstants firstCriterion,[in, defaultvalue(sobText)] SortByConstants secondCriterion,[in, defaultvalue(sobNone)] SortByConstants thirdCriterion,[in, defaultvalue(0)] VARIANT_BOOL caseSensitive)
	Sorts the control's groups
HRESULT	SortItems ([in, defaultvalue(sobShell)] SortByConstants firstCriterion,[in, defaultvalue(sobText)] SortByConstants secondCriterion,[in, defaultvalue(sobNone)] SortByConstants thirdCriterion,[in, defaultvalue(sobNone)] SortByConstants fourthCriterion,[in, defaultvalue(sobNone)] SortByConstants fifthCriterion,[in, optional] VARIANT column,[in, defaultvalue(0)] VARIANT_BOOL caseSensitive)
	Sorts the control's items
Properties
VARIANT_BOOL	AbsoluteBkImagePosition [get, set]
	Controls the position of the control's background image
VARIANT_BOOL	AllowHeaderDragDrop [get, set]
	Specifies whether the control detects column drag'n'drop operations
VARIANT_BOOL	AllowLabelEditing [get, set]
	Specifies whether label-editing mode can be entered
VARIANT_BOOL	AlwaysShowSelection [get, set]
	Controls how the selected item is displayed
IListViewItem	AnchorItem [get, set]
	Specifies the control's selection anchor item
AppearanceConstants	Appearance [get, set]
	Controls the style of the control's outer border
AutoArrangeItemsConstants	AutoArrangeItems [get, set]
	Controls arrangement of the control's items
VARIANT_BOOL	AutoSizeColumns [get, set]
	Controls automatic column resizing
OLE_COLOR	BackColor [get, set]
	Specifies the control's background color
BackgroundDrawModeConstants	BackgroundDrawMode [get, set]
	Controls how the control's background is drawn
VARIANT	BkImage [get, set]
	Specifies the control's background image
LONG	BkImagePositionX [get, set]
	Controls the position of the control's background image
LONG	BkImagePositionY [get, set]
	Controls the position of the control's background image
BkImageStyleConstants	BkImageStyle [get, set]
	Controls the appearance of the control's background image
VARIANT_BOOL	BlendSelectionLasso [get, set]
	Controls the appearance of the control's selection lasso
VARIANT_BOOL	BorderSelect [get, set]
	Controls the appearance of selected items
BorderStyleConstants	BorderStyle [get, set]
	Controls the style of the control's inner border
CallBackMaskConstants	CallBackMask [get, set]
	Controls when the ItemGetDisplayInfo event is fired
IListViewColumn	CaretColumn [get, set]
	Specifies the control's caret column header
IListViewFooterItem	CaretFooterItem [get, set]
	Specifies the control's caret footer item
IListViewGroup	CaretGroup [get, set]
	Specifies the control's caret group
IListViewItem	CaretItem ([in, defaultvalue(0)] VARIANT_BOOL changeFocusOnly) [get, set]
	Specifies the control's caret item
VARIANT_BOOL	CheckItemOnSelect [get, set]
	Specifies whether selecting an item changes its state image
VARIANT_BOOL	ClickableColumnHeaders [get, set]
	Specifies whether the control's column headers are button-like
ColumnHeaderVisibilityConstants	ColumnHeaderVisibility [get, set]
	Controls the visibility of the column headers
IListViewColumns	Columns [get]
	Retrieves the control's columns
OLE_XSIZE_PIXELS	ColumnWidth [get, set]
	Specifies the column width in 'List' view
DisabledEventsConstants	DisabledEvents [get, set]
	Controls which events are fired
VARIANT_BOOL	DontRedraw [get, set]
	Controls redrawing of the control
IListViewColumn	DraggedColumn [get]
	Retrieves the column currently dragged
IListViewItemContainer	DraggedItems [get]
	Retrieves the items currently dragged
LONG	DragScrollTimeBase [get, set]
	Controls the speed of automatic scrolling during drag'n'drop
VARIANT_BOOL	DrawImagesAsynchronously [get, set]
	Controls the control's asynchronous drawing features
IListViewItem	DropHilitedItem [get, set]
	Specifies the item that currently is the drop target
OLE_COLOR	EditBackColor [get, set]
	Specifies the contained edit control's background color
OLE_COLOR	EditForeColor [get, set]
	Specifies the contained edit control's text color
LONG	EditHoverTime [get, set]
	Controls when the EditMouseHover event is fired
IMEModeConstants	EditIMEMode [get, set]
	Controls the control's IME features
BSTR	EditText [get, set]
	Specifies the contained edit control's content
BSTR	EmptyMarkupText [get, set]
	Specifies the text that is displayed if the control does not contain any items
AlignmentConstants	EmptyMarkupTextAlignment [get, set]
	Specifies the alignment of the text that is displayed if the control does not contain any items
VARIANT_BOOL	Enabled [get, set]
	Controls whether the control accepts user input
LONG	FilterChangedTimeout [get, set]
	Controls when the FilterChanged event is fired
IListViewItem	FirstVisibleItem [get]
	Retrieves the control's first item that is displayed in the control's client area
IFontDisp	Font [get, set]
	Specifies the control's font
BSTR	FooterIntroText [get, set]
	Specifies the text that is displayed in the footer area's caption
IListViewFooterItems	FooterItems [get]
	Retrieves the control's footer items
OLE_COLOR	ForeColor [get, set]
	Specifies the control's text color
FullRowSelectConstants	FullRowSelect [get, set]
	Controls the control's selection style
VARIANT_BOOL	GridLines [get, set]
	Specifies whether gridlines are drawn in 'Details' view
OLE_COLOR	GroupFooterForeColor [get, set]
	Specifies the control's group footer text color
OLE_COLOR	GroupHeaderForeColor [get, set]
	Specifies the control's group header text color
OLE_YSIZE_PIXELS	GroupMarginBottom [get, set]
	Specifies the control's group bottom margin
OLE_XSIZE_PIXELS	GroupMarginLeft [get, set]
	Specifies the control's group left margin
OLE_XSIZE_PIXELS	GroupMarginRight [get, set]
	Specifies the control's group right margin
OLE_YSIZE_PIXELS	GroupMarginTop [get, set]
	Specifies the control's group top margin
IListViewGroups	Groups [get]
	Retrieves the control's groups
SortOrderConstants	GroupSortOrder [get, set]
	Specifies the control's group sorting direction
OLE_HANDLE	hDragImageList [get]
	Retrieves the imagelist containing the drag image
VARIANT_BOOL	HeaderFullDragging [get, set]
	Specifies the appearance of columns while they are resized
VARIANT_BOOL	HeaderHotTracking [get, set]
	Controls the control's mouse-hover effects
LONG	HeaderHoverTime [get, set]
	Controls when the HeaderMouseHover event is fired
OLEDragImageStyleConstants	HeaderOLEDragImageStyle [get, set]
	Specifies the appearance of the OLE drag images generated by the control
VARIANT_BOOL	HideLabels [get, set]
	Specifies the visibility of item labels
OLE_HANDLE	hImageList ([in] ImageListConstants imageList) [get, set]
	Specifies one of the control's associated image list
OLE_COLOR	HotForeColor [get, set]
	Specifies the control's text color for hot items
IListViewItem	HotItem [get, set]
	Specifies the control's hot item
IPictureDisp	HotMouseIcon [get, set]
	Controls the control's mouse cursor
MousePointerConstants	HotMousePointer [get, set]
	Controls the control's mouse cursor
VARIANT_BOOL	HotTracking [get, set]
	Controls the control's mouse-hover effects
LONG	HotTrackingHoverTime [get, set]
	Controls automatic item selection in hot-tracking mode
LONG	HoverTime [get, set]
	Controls when the MouseHover event is fired
OLE_HANDLE	hWnd [get]
	Retrieves the control's window handle
OLE_HANDLE	hWndEdit [get]
	Retrieves the contained edit control's window handle
OLE_HANDLE	hWndHeader [get]
	Retrieves the contained header control's window handle
OLE_HANDLE	hWndToolTip [get, set]
	Specifies the tooltip control's window handle
IMEModeConstants	IMEMode [get, set]
	Controls the control's IME features
VARIANT_BOOL	IncludeHeaderInTabOrder [get, set]
	Specifies whether the keyboard focus can be set to the header control by pressing the [TAB] key
BSTR	IncrementalSearchString [get]
	Retrieves the control's current incremental search-string
OLE_COLOR	InsertMarkColor [get, set]
	Specifies the color of the control's insertion mark
ItemActivationModeConstants	ItemActivationMode [get, set]
	Controls when the ItemActivate event is fired
ItemAlignmentConstants	ItemAlignment [get, set]
	Controls alignment of the control's items
ItemBoundingBoxDefinitionConstants	ItemBoundingBoxDefinition [get, set]
	Specifies which parts of an item are handled as such
OLE_YSIZE_PIXELS	ItemHeight [get, set]
	Specifies the items' height
VARIANT_BOOL	JustifyIconColumns [get, set]
	Controls the spacing between items in 'Icons' view
VARIANT_BOOL	LabelWrap [get, set]
	Controls the appearance of item labels
IListViewItems	ListItems [get]
	Retrieves the control's items
LONG	MinItemRowsVisibleInGroups [get, set]
	Specifies the number of item rows visible in subseted groups
IPictureDisp	MouseIcon [get, set]
	Controls the control's mouse cursor
MousePointerConstants	MousePointer [get, set]
	Controls the control's mouse cursor
VARIANT_BOOL	MultiSelect [get, set]
	Specifies whether multiple items can be selected
OLEDragImageStyleConstants	OLEDragImageStyle [get, set]
	Specifies the appearance of the OLE drag images generated by the control
OLE_COLOR	OutlineColor [get, set]
	Controls the appearance of unselected items
VARIANT_BOOL	OwnerDrawn [get, set]
	Specifies whether the items are drawn by the application instead of the control
VARIANT_BOOL	ProcessContextMenuKeys [get, set]
	Specifies whether the ContextMenu event can be invoked using the keyboard
VARIANT_BOOL	Regional [get, set]
	Controls the control's window region
VARIANT_BOOL	RegisterForOLEDragDrop [get, set]
	Controls the control's behavior in drag'n'drop operations
VARIANT_BOOL	ResizableColumns [get, set]
	Specifies whether the control's columns can be resized
RightToLeftConstants	RightToLeft [get, set]
	Controls the control's right-to-left features
ScrollBarsConstants	ScrollBars [get, set]
	Specifies the scrollbars to show
IListViewColumn	SelectedColumn [get, set]
	Specifies the control's selected column
OLE_COLOR	SelectedColumnBackColor [get, set]
	Specifies the selected column's background color
VARIANT_BOOL	ShowDragImage [get, set]
	Controls the visibility of the control's drag image
VARIANT_BOOL	ShowFilterBar [get, set]
	Specifies whether the control's header control is extended by a filter bar
VARIANT_BOOL	ShowGroups [get, set]
	Specifies whether the control's items are organized in groups
VARIANT_BOOL	ShowHeaderChevron [get, set]
	Specifies whether the header control displays a chevron if not all column headers can be displayed
VARIANT_BOOL	ShowHeaderStateImages [get, set]
	Specifies whether the control draws state images into the column headers
VARIANT_BOOL	ShowStateImages [get, set]
	Specifies whether the control draws state images next to the items
VARIANT_BOOL	ShowSubItemImages [get, set]
	Specifies whether the control draws state images next to the sub-items
VARIANT_BOOL	SimpleSelect [get, set]
	Controls state image changing
VARIANT_BOOL	SingleRow [get, set]
	Controls arrangement of the control's items
VARIANT_BOOL	SnapToGrid [get, set]
	Controls positioning of the control's items
SortOrderConstants	SortOrder [get, set]
	Specifies the control's sorting direction
VARIANT_BOOL	SupportOLEDragImages [get, set]
	Controls the control's behavior in drag'n'drop operations
OLE_COLOR	TextBackColor [get, set]
	Controls the appearance of item labels
LONG	TileViewItemLines [get, set]
	Controls the control's appearance in 'Tiles' and 'Extended Tiles' view
OLE_YSIZE_PIXELS	TileViewLabelMarginBottom [get, set]
	Controls the item labels' appearance in 'Tiles' and 'Extended Tiles' view
OLE_XSIZE_PIXELS	TileViewLabelMarginLeft [get, set]
	Controls the item labels' appearance in 'Tiles' and 'Extended Tiles' view
OLE_XSIZE_PIXELS	TileViewLabelMarginRight [get, set]
	Controls the item labels' appearance in 'Tiles' and 'Extended Tiles' view
OLE_YSIZE_PIXELS	TileViewLabelMarginTop [get, set]
	Controls the item labels' appearance in 'Tiles' and 'Extended Tiles' view
OLE_COLOR	TileViewSubItemForeColor [get, set]
	Specifies the text color of sub-items in 'Tiles' and 'Extended Tiles' view
OLE_YSIZE_PIXELS	TileViewTileHeight [get, set]
	Controls the tiles' size in 'Tiles' and 'Extended Tiles' view
OLE_XSIZE_PIXELS	TileViewTileWidth [get, set]
	Controls the tiles' size in 'Tiles' and 'Extended Tiles' view
ToolTipsConstants	ToolTips [get, set]
	Specifies which kinds of tooltips are displayed
UnderlinedItemsConstants	UnderlinedItems [get, set]
	Specifies which kinds of items are drawn underlined
VARIANT_BOOL	UseMinColumnWidths [get, set]
	Specifies whether the control applies the columns' minimum widths
VARIANT_BOOL	UseSystemFont [get, set]
	Specifies whether the control uses the system font
VARIANT_BOOL	UseWorkAreas [get, set]
	Specifies whether the control's items are arranged in working areas
BSTR	Version [get]
	Retrieves the control's version
ViewConstants	View [get, set]
	Specifies the control's view mode
LONG	VirtualItemCount ([in, defaultvalue(0)] VARIANT_BOOL noScroll,[in, defaultvalue(-1)] VARIANT_BOOL noInvalidateAll) [get, set]
	Specifies the number of items in virtual mode
VARIANT_BOOL	VirtualMode [get, set]
	Specifies whether data-management is done by the application instead of the control
IListViewWorkAreas	WorkAreas [get]
	Retrieves the control's working areas

---

Detailed Description

The main interface

This is the control's main interface. It wraps the control window.

See also:

_IExplorerListViewEvents

---

Member Function Documentation

HRESULT About

(

void

)

Displays the control's credits

Displays some information about this control and its author.

HRESULT ApproximateViewRectangle	(	[in, defaultvalue(-1)] LONG	numberOfItems,
		[in, out, defaultvalue(0)] OLE_XSIZE_PIXELS *	proposedWidth,
		[in, out, defaultvalue(0)] OLE_YSIZE_PIXELS *	proposedHeight
	)

Approximates the listview's optimal size

Calculates the control's approximate width and height required to display the specified number of items. Setting the size of the control based on the dimensions provided by this method can optimize redraw and reduce flicker.

Parameters:

[in]	numberOfItems	The number of items to be displayed in the control. If set to -1, the control's total number of items is used.
[in,out]	proposedWidth	The approximated width (in pixels) needed to display the items. If set to -1 on entry, the control's current width will be used as base to calculate the optimal width.
[in,out]	proposedHeight	The approximated height (in pixels) needed to display the items. If set to -1 on entry, the control's current height will be used as base to calculate the optimal height.

See also:

GetViewRectangle

HRESULT ArrangeItems

(

[in, defaultvalue(astDefault)] ArrangementStyleConstants

arrangementStyle )

Arranges the listview's items

Arranges the control's items in 'Icons', 'Small Icons', 'Tiles' or 'Extended Tiles' view.

Parameters:

[in]

arrangementStyle

Specifies how the items will be arranged. Any of the values defined by the ArrangementStyleConstants enumeration is valid.

See also:

AutoArrangeItems, SnapToGrid, View, IListViewItem::SetPosition, ArrangementStyleConstants

HRESULT BeginDrag	(	[in] IListViewItemContainer *	draggedItems,
		[in, defaultvalue(0)] OLE_HANDLE	hDragImageList,
		[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *	xHotSpot,
		[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *	yHotSpot
	)

Enters drag'n'drop mode

Parameters:

[in]	draggedItems	A collection object containing the items to drag.
[in]	hDragImageList	The imagelist containing the drag image that shall be used to visualize the drag'n'drop operation. If -1, the control creates the drag image itself; if 0, no drag image is used.
[in,out]	xHotSpot	The x-coordinate (in pixels) of the drag image's hotspot relative to the drag image's upper-left corner. If the hDragImageList parameter is set to -1 or 0, this parameter is ignored. This parameter will be changed to the value that finally was used by the method.
[in,out]	yHotSpot	The y-coordinate (in pixels) of the drag image's hotspot relative to the drag image's upper-left corner. If the hDragImageList parameter is set to -1 or 0, this parameter is ignored. This parameter will be changed to the value that finally was used by the method.

See also:

OLEDrag, DraggedItems, EndDrag, HeaderBeginDrag, hDragImageList, _IExplorerListViewEvents::ItemBeginDrag, _IExplorerListViewEvents::ItemBeginRDrag, IListViewItem::CreateDragImage, IListViewItemContainer::CreateDragImage

HRESULT CountVisible

(

[out, retval] LONG *

pValue )

Calculates the maximum number of entirely visible items within the listview

Retrieves the number of items that fit entirely into the control's client area.

Returns:

The maximum number of simultaneous visible items.

Remarks:

This method is valid for 'List' and 'Details' view only.

See also:

IListViewItems::Count, View

HRESULT CreateItemContainer	(	[in, optional] VARIANT	items,
		[out, retval] IListViewItemContainer **	ppContainer
	)

Creates a new ListViewItemContainer object

Retrieves a new ListViewItemContainer object and fills it with the specified items.

Parameters:

[in]

items

The item(s) to add to the collection. May be either Empty, an item ID, a ListViewItem object or a ListViewItems collection.

Returns:

The created ListViewItemContainer object.

See also:

IListViewItemContainer::Clone, IListViewItemContainer::Add

HRESULT EndDrag

(

[in] VARIANT_BOOL

abort )

Exits drag'n'drop mode

Parameters:

[in]

abort

If True, the drag'n'drop operation will be handled as aborted; otherwise it will be handled as a drop.

See also:

DraggedItems, BeginDrag, HeaderEndDrag, _IExplorerListViewEvents::AbortedDrag, _IExplorerListViewEvents::Drop

HRESULT EndLabelEdit

(

[in] VARIANT_BOOL

discard )

Ends label-editing

Ends editing the item's text.

Parameters:

[in]

discard

Specifies whether to apply or discard the text contained by the label-edit control at the time this method is called. If set to True, the text is discarded and the edited item's text remains the same; otherwise the edited item's text is changed to the text contained by the label-edit control at the time this method is called.

See also:

IListViewItem::StartLabelEditing, _IExplorerListViewEvents::RenamedItem, _IExplorerListViewEvents::ItemSetText

HRESULT FindItem	(	[in] SearchModeConstants	searchMode,
		[in] VARIANT	searchFor,
		[in, defaultvalue(sdNoneSpecific)] SearchDirectionConstants	searchDirection,
		[in, defaultvalue(-1)] VARIANT_BOOL	wrapAtLastItem,
		[out, retval] IListViewItem **	ppFoundItem
	)

Finds an item with the specified characteristics

Retrieves an item with the specified characteristics.

Parameters:

[in]	searchMode	A value specifying the meaning of the searchFor parameter. Any of the values defined by the SearchModeConstants enumeration is valid.
[in]	searchFor	The criterion that the item must fulfill to be returned by this method. This parameter's format depends on the searchMode parameter: smItemData An integer value. smText A string value. smPartialText A string value. smNearestPosition An array containing two integer values. The first one specifies the x-coordinate, the second one the y-coordinate (both in pixels and relative to the control's upper-left corner).
[in]	searchDirection	A value specifying the direction to search. Any of the values defined by the SearchDirectionConstants enumeration is valid. This parameter is ignored if the searchFor parameter is not set to smNearestPosition.
[in]	wrapAtLastItem	If set to True, the search will be continued with the first item if the last item is reached. This parameter is ignored if searchMode is set to smNearestPosition.

Returns:

The item with the specified characteristics. Nothing if no matching item was found.

See also:

IListViewItem::FindNextItem, SearchModeConstants, SearchDirectionConstants, _IExplorerListViewEvents::FindVirtualItem

HRESULT GetClosestInsertMarkPosition	(	[in] OLE_XPOS_PIXELS	x,
		[in] OLE_YPOS_PIXELS	y,
		[in, out] InsertMarkPositionConstants *	relativePosition,
		[in, out] IListViewItem **	listItem
	)

Proposes a position for the control's insertion mark

Retrieves the insertion mark position that is closest to the specified point.

Parameters:

[in]	x	The x-coordinate (in pixels) of the point for which to retrieve the closest insertion mark position. It must be relative to the control's upper-left corner.
[in]	y	The y-coordinate (in pixels) of the point for which to retrieve the closest insertion mark position. It must be relative to the control's upper-left corner.
[out]	relativePosition	The insertion mark's position relative to the specified item. The following values, defined by the InsertMarkPositionConstants enumeration, are valid: impBefore, impAfter, impNowhere.
[out]	listItem	The item at which the insertion mark should be displayed.

Remarks:

An insertion mark can be used only if the control is in 'Icons', 'Small Icons', 'Tiles' or 'Extended Tiles' view, is not in group-view mode, and has AutoArrangeItems set to aaiNormal.
Requires comctl32.dll version 6.0 or higher.

See also:

SetInsertMarkPosition, GetInsertMarkPosition, AutoArrangeItems, ShowGroups, View, InsertMarkPositionConstants

HRESULT GetFooterRectangle	(	[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *	xLeft,
		[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *	yTop,
		[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *	xRight,
		[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *	yBottom
	)

Retrieves the bounding rectangle of the control's footer area

Retrieves the bounding rectangle (in pixels relative to the control's client area) of the control's footer area.

Parameters:

[out]	xLeft	The x-coordinate (in pixels) of the bounding rectangle's left border relative to the control's upper-left corner.
[out]	yTop	The y-coordinate (in pixels) of the bounding rectangle's top border relative to the control's upper-left corner.
[out]	xRight	The x-coordinate (in pixels) of the bounding rectangle's right border relative to the control's upper-left corner.
[out]	yBottom	The y-coordinate (in pixels) of the bounding rectangle's bottom border relative to the control's upper-left corner.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

ShowFooter, IListViewFooterItem::GetRectangle

HRESULT GetHeaderChevronRectangle	(	[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *	Left,
		[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *	Top,
		[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *	Right,
		[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *	Bottom
	)

Retrieves the bounding rectangle of the column header's chevron button

Retrieves the bounding rectangle (in pixels relative to the header control's upper-left corner) of the column header's chevron button which is displayed if the column headers are wider than the control and therefore can't be displayed all together.

Parameters:

[in,out]	left	The x-coordinate (in pixels) of the upper-left corner of the chevron button's bounding rectangle relative to the header control's upper-left corner.
[in,out]	top	The y-coordinate (in pixels) of the upper-left corner of the chevron button's bounding rectangle relative to the header control's upper-left corner.
[in,out]	right	The x-coordinate (in pixels) of the lower-right corner of the chevron button's bounding rectangle relative to the header control's upper-left corner.
[in,out]	bottom	The y-coordinate (in pixels) of the lower-right corner of the chevron button's bounding rectangle relative to the header control's upper-left corner.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

ShowHeaderChevron

HRESULT GetIconSpacing	(	[in] ViewConstants	viewMode,
		[in, out, defaultvalue(0)] OLE_XSIZE_PIXELS *	itemWidth,
		[in, out, defaultvalue(0)] OLE_YSIZE_PIXELS *	itemHeight
	)

Determines the spacing between items in 'Icons' or 'Small Icons' view

Determines an item's width and height (including the space beneath it) in 'Icons' or 'Small Icons' view in pixels.

Parameters:

[in]	viewMode	The view for which to determine the spacing. The following values, defined by the ViewConstants enumeration, are valid: vIcons, vSmallIcons.
[out]	itemWidth	The item's width (including the space beneath it) in pixels.
[out]	itemHeight	The item's height (including the space beneath it) in pixels.

See also:

SetIconSpacing, View, ViewConstants

HRESULT GetInsertMarkPosition	(	[in, out] InsertMarkPositionConstants *	relativePosition,
		[in, out] IListViewItem **	listItem
	)

Retrieves the position of the control's insertion mark

Parameters:

[out]	relativePosition	The insertion mark's position relative to the specified item. The following values, defined by the InsertMarkPositionConstants enumeration, are valid: impBefore, impAfter, impNowhere.
[out]	listItem	The item at which the insertion mark is displayed.

Remarks:

An insertion mark can be used only if the control is in 'Icons', 'Small Icons', 'Tiles' or 'Extended Tiles' view, is not in group-view mode, and has AutoArrangeItems set to aaiNormal.
Requires comctl32.dll version 6.0 or higher.

See also:

SetInsertMarkPosition, GetClosestInsertMarkPosition, GetInsertMarkRectangle, AutoArrangeItems, ShowGroups, View, InsertMarkPositionConstants

HRESULT GetInsertMarkRectangle	(	[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *	xLeft,
		[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *	yTop,
		[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *	xRight,
		[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *	yBottom
	)

Retrieves the bounding rectangle of the control's insertion mark

Parameters:

[out]	xLeft	The x-coordinate (in pixels) of the bounding rectangle's left border relative to the control's upper-left corner.
[out]	yTop	The y-coordinate (in pixels) of the bounding rectangle's top border relative to the control's upper-left corner.
[out]	xRight	The x-coordinate (in pixels) of the bounding rectangle's right border relative to the control's upper-left corner.
[out]	yBottom	The y-coordinate (in pixels) of the bounding rectangle's bottom border relative to the control's upper-left corner.

Remarks:

An insertion mark can be used only if the control is in 'Icons', 'Small Icons', 'Tiles' or 'Extended Tiles' view, is not in group-view mode, and has AutoArrangeItems set to aaiNormal.
Requires comctl32.dll version 6.0 or higher.

See also:

GetInsertMarkPosition, SetInsertMarkPosition, AutoArrangeItems, ShowGroups, View

HRESULT GetOrigin	(	[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *	x,
		[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *	y
	)

Retrieves the control's current view origin

Parameters:

[out]	x	The x-coordinate (in pixels) of the view origin relative to the control's upper-left corner.
[out]	y	The y-coordinate (in pixels) of the view origin relative to the control's upper-left corner.

Remarks:

This method will fail if the control is in 'List' or 'Details' view.

See also:

Scroll, GetViewRectangle, View

HRESULT GetStringWidth	(	[in] BSTR	stringToTest,
		[out, retval] OLE_XSIZE_PIXELS *	pWidth
	)

Determines the width of the specified string using the control's current font

Determines the width (in pixels) of the specified string using the control's current font.

Parameters:

[in]

stringToTest

The string for which to determine the width.

Returns:

The string's width in pixels.

See also:

IListViewColumn::Width, _IExplorerListViewEvents::CustomDraw

HRESULT GetViewRectangle	(	[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *	xLeft,
		[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *	yTop,
		[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *	xRight,
		[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *	yBottom
	)

Retrieves the bounding rectangle of all items in the control

Parameters:

[out]	xLeft	The x-coordinate (in pixels) of the bounding rectangle's left border relative to the control's upper-left corner.
[out]	yTop	The y-coordinate (in pixels) of the bounding rectangle's top border relative to the control's upper-left corner.
[out]	xRight	The x-coordinate (in pixels) of the bounding rectangle's right border relative to the control's upper-left corner.
[out]	yBottom	The y-coordinate (in pixels) of the bounding rectangle's bottom border relative to the control's upper-left corner.

Remarks:

This method will fail if the listview is in 'List' or 'Details' view.

See also:

GetOrigin, Scroll, View

HRESULT HeaderBeginDrag	(	[in] IListViewColumn *	draggedColumn,
		[in, defaultvalue(0)] OLE_HANDLE	hDragImageList,
		[in, out, defaultvalue(0)] OLE_XPOS_PIXELS *	xHotSpot,
		[in, out, defaultvalue(0)] OLE_YPOS_PIXELS *	yHotSpot,
		[in, defaultvalue(-1)] VARIANT_BOOL	restrictDragImage
	)

Enters drag'n'drop mode

Enters drag'n'drop mode for the header control.

Parameters:

[in]	draggedColumn	The column header to drag.
[in]	hDragImageList	The imagelist containing the drag image that shall be used to visualize the drag'n'drop operation. If -1, the control creates the drag image itself; if 0, no drag image is used.
[in,out]	xHotSpot	The x-coordinate (in pixels) of the drag image's hotspot relative to the drag image's upper-left corner. If the hDragImageList parameter is set to -1 or 0, this parameter is ignored. This parameter will be changed to the value that finally was used by the method.
[in,out]	yHotSpot	The y-coordinate (in pixels) of the drag image's hotspot relative to the drag image's upper-left corner. If the hDragImageList parameter is set to -1 or 0, this parameter is ignored. This parameter will be changed to the value that finally was used by the method.
[in]	restrictDragImage	If set to True, the drag image will move within the header control along the x-axis only. If set to False, the drag image will be attached to the mouse cursor and move freely.

See also:

HeaderOLEDrag, DraggedColumn, HeaderEndDrag, hDragImageList, BeginDrag, _IExplorerListViewEvents::ColumnBeginDrag, IListViewColumn::CreateDragImage

HRESULT HeaderEndDrag

(

[in] VARIANT_BOOL

abort )

Exits drag'n'drop mode

Parameters:

[in]

abort

If True, the drag'n'drop operation will be handled as aborted; otherwise it will be handled as a drop.

Remarks:

You shouldn't call this method if you've chosen to use automatic drag'n'drop in your ColumnBeginDrag event handler.

See also:

DraggedColumn, HeaderBeginDrag, EndDrag, _IExplorerListViewEvents::HeaderAbortedDrag, _IExplorerListViewEvents::HeaderDrop, _IExplorerListViewEvents::ColumnBeginDrag

HRESULT HeaderHitTest	(	[in] OLE_XPOS_PIXELS	x,
		[in] OLE_YPOS_PIXELS	y,
		[in, out] HeaderHitTestConstants *	hitTestDetails,
		[out, retval] IListViewColumn **	ppHitColumn
	)

Hit-tests the specified point

Retrieves the header control's parts that lie below the point ('x'; 'y').

Parameters:

[in]	x	The x-coordinate (in pixels) of the point to check. It must be relative to the header control's upper-left corner.
[in]	y	The y-coordinate (in pixels) of the point to check. It must be relative to the header control's upper-left corner.
[in,out]	hitTestDetails	Receives a value specifying the exact part of the header control the specified point lies in. Any of the values defined by the HeaderHitTestConstants enumeration is valid.

Returns:

The column that the specified point belongs to. Nothing, if no column was "hit".

Remarks:

Scrolling the control moves the header control, so that a point's listview coordinates (i. e. relative to the control's upper-left corner) don't necessarily equal the same point's header coordinates (i. e. relative to the header control's upper-left corner).

See also:

HeaderHitTestConstants

HRESULT HeaderOLEDrag	(	[in, defaultvalue(NULL)] LONG *	pDataObject,
		[in, defaultvalue(odeCopyOrMove)] OLEDropEffectConstants	supportedEffects,
		[in, defaultvalue(-1)] OLE_HANDLE	hWndToAskForDragImage,
		[in, defaultvalue(NULL)] IListViewColumn *	draggedColumnHeader,
		[in, defaultvalue(-1)] LONG	itemCountToDisplay,
		[out, retval] OLEDropEffectConstants *	pPerformedEffects
	)

Enters OLE drag'n'drop mode

Parameters:

[in]	pDataObject	A pointer to the IDataObject implementation to use during OLE drag'n'drop. If not specified, the control's own implementation is used.
[in]	supportedEffects	A bit field defining all drop effects you want to support. Any combination of the values defined by the OLEDropEffectConstants enumeration (except odeScroll) is valid.
[in]	hWndToAskForDragImage	The handle of the window, that will receive the DI_GETDRAGIMAGE message to specify the drag image to use. If -1, the control creates the drag image itself. If SupportOLEDragImages is set to False, no drag image is used.
[in]	draggedColumnHeader	The column header to drag. This parameter is used to generate the drag image, if hWndToAskForDragImage is set to -1.
[in]	itemCountToDisplay	The number to display in the item count label of Aero drag images. If set to -1, 0 or 1, no item count label is displayed. If set to any value larger than 1, this value is displayed in the item count label.

Returns:

The performed drop effect. Any of the values defined by the OLEDropEffectConstants enumeration (except odeScroll) is valid.

See also:

HeaderBeginDrag, OLEDrag, _IExplorerListViewEvents::ColumnBeginDrag, _IExplorerListViewEvents::HeaderOLEStartDrag, _IExplorerListViewEvents::HeaderOLEGiveFeedback, _IExplorerListViewEvents::HeaderOLEQueryContinueDrag, SupportOLEDragImages, HeaderOLEDragImageStyle, OLEDropEffectConstants, DI_GETDRAGIMAGE

HRESULT HeaderRefresh

(

void

)

Advises the header control to redraw itself

See also:

Refresh

HRESULT HitTest	(	[in] OLE_XPOS_PIXELS	x,
		[in] OLE_YPOS_PIXELS	y,
		[in, out] HitTestConstants *	hitTestDetails,
		[in, out, optional] VARIANT *	hitSubItem,
		[in, out, optional] VARIANT *	hitGroup,
		[in, out, optional] VARIANT *	hitFooterItem,
		[out, retval] IListViewItem **	ppHitItem
	)

Hit-tests the specified point

Retrieves the control's parts that lie below the point ('x'; 'y').

Parameters:

[in]	x	The x-coordinate (in pixels) of the point to check. It must be relative to the control's upper-left corner.
[in]	y	The y-coordinate (in pixels) of the point to check. It must be relative to the control's upper-left corner.
[in,out]	hitTestDetails	Receives a value specifying the exact part of the control the specified point lies in. Any of the values defined by the HitTestConstants enumeration is valid.
[in,out]	hitSubItem	Receives the sub-item that the specified point belongs to. Will be Nothing, if no sub-item was "hit".
[in,out]	hitGroup	Receives the group that the specified point belongs to. Will be Nothing, if no group was "hit". Requires comctl32.dll version 6.10 or higher.
[in,out]	hitFooterItem	Receives the footer item that the specified point belongs to. Will be Nothing, if no footer item was "hit". Requires comctl32.dll version 6.10 or higher.

Returns:

The item that the specified point belongs to. Nothing, if no item was "hit".

See also:

ItemBoundingBoxDefinition, HitTestConstants, ListViewSubItem, ListViewGroup, ListViewFooterItem

HRESULT IsFooterVisible

(

[out, retval] VARIANT_BOOL *

pVisible )

Retrieves whether the footer area is currently displayed

Retrieves whether the control's footer area is currently displayed.

Returns:

True if the footer area is visible; otherwise False.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

ShowFooter, FooterItems

HRESULT LoadSettingsFromFile	(	[in] BSTR	file,
		[out, retval] VARIANT_BOOL *	pSucceeded
	)

Loads the control's settings from the specified file

Parameters:

[in]

file

The file to read from.

Returns:

True if the settings could be loaded; otherwise False.

See also:

SaveSettingsToFile

HRESULT OLEDrag	(	[in, defaultvalue(NULL)] LONG *	pDataObject,
		[in, defaultvalue(odeCopyOrMove)] OLEDropEffectConstants	supportedEffects,
		[in, defaultvalue(-1)] OLE_HANDLE	hWndToAskForDragImage,
		[in, defaultvalue(NULL)] IListViewItemContainer *	draggedItems,
		[in, defaultvalue(-1)] LONG	itemCountToDisplay,
		[out, retval] OLEDropEffectConstants *	pPerformedEffects
	)

Enters OLE drag'n'drop mode

Parameters:

[in]	pDataObject	A pointer to the IDataObject implementation to use during OLE drag'n'drop. If not specified, the control's own implementation is used.
[in]	supportedEffects	A bit field defining all drop effects you want to support. Any combination of the values defined by the OLEDropEffectConstants enumeration (except odeScroll) is valid.
[in]	hWndToAskForDragImage	The handle of the window, that will receive the DI_GETDRAGIMAGE message to specify the drag image to use. If -1, the control creates the drag image itself. If SupportOLEDragImages is set to False, no drag image is used.
[in]	draggedItems	A collection object containing the items to drag. This parameter is used to generate the drag image, if hWndToAskForDragImage is set to -1.
[in]	itemCountToDisplay	The number to display in the item count label of Aero drag images. If set to 0 or 1, no item count label is displayed. If set to -1, the number of items contained in the draggedItems collection is displayed in the item count label. If set to any value larger than 1, this value is displayed in the item count label.

Returns:

The performed drop effect. Any of the values defined by the OLEDropEffectConstants enumeration (except odeScroll) is valid.

See also:

BeginDrag, HeaderOLEDrag, _IExplorerListViewEvents::ItemBeginDrag, _IExplorerListViewEvents::ItemBeginRDrag, _IExplorerListViewEvents::OLEStartDrag, _IExplorerListViewEvents::OLEGiveFeedback, _IExplorerListViewEvents::OLEQueryContinueDrag, SupportOLEDragImages, OLEDragImageStyle, OLEDropEffectConstants, DI_GETDRAGIMAGE

HRESULT RedrawItems	(	[in, defaultvalue(0)] LONG	iFirstItem,
		[in, defaultvalue(-1)] LONG	iLastItem
	)

Redraws a range of items

Parameters:

[in]	iFirstItem	The index of the first item to redraw.
[in]	iLastItem	The index of the last item to redraw.

Remarks:

The specified items are not actually redrawn until the control receives a WM_PAINT message to repaint. To repaint immediately, call the Refresh method.

See also:

Refresh, IListViewItem::Update

HRESULT Refresh

(

void

)

Advises the control to redraw itself

See also:

HeaderRefresh, RedrawItems

HRESULT SaveSettingsToFile	(	[in] BSTR	file,
		[out, retval] VARIANT_BOOL *	pSucceeded
	)

Saves the control's settings to the specified file

Parameters:

[in]

file

The file to write to.

Returns:

True if the settings could be saved; otherwise False.

See also:

LoadSettingsFromFile

HRESULT Scroll	(	[in] OLE_XSIZE_PIXELS	horizontalDistance,
		[in] OLE_YSIZE_PIXELS	verticalDistance
	)

Scrolls the control's content

Parameters:

[in]	horizontalDistance	The amount of horizontal scrolling in pixels. If the control is in 'List' view, this value specifies the number of columns to scroll.
[in]	verticalDistance	The amount of vertical scrolling in pixels. If the control is in 'Details' view, this value will be rounded, so that the control is scrolled in whole line increments.

See also:

_IExplorerListViewEvents::BeforeScroll, _IExplorerListViewEvents::AfterScroll, GetOrigin, GetViewRectangle, View

HRESULT SetFocusToHeader

(

void

)

Sets the keyboard focus to the header control

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

CaretColumn, IListViewColumn::Caret

HRESULT SetHeaderInsertMarkPosition	(	[in, defaultvalue(0)] LONG	position,
		[in, defaultvalue(0x80000000)] LONG	x,
		[in, defaultvalue(0x80000000)] LONG	y,
		[out, retval] LONG *	pPosition
	)

Sets the position of the header control's insertion mark

Parameters:

[in]	position	The zero-based index of the column divider to highlight. The column divider to the left of the first column is the 0th one. If set to -1, the insertion mark is removed.
[in]	x	The x-coordinate (in pixels) of a point relative to the header control's upper-left corner. The header control will highlight the column divider nearest to this point.
[in]	y	The y-coordinate (in pixels) of a point relative to the header control's upper-left corner. The header control will highlight the column divider nearest to this point.

Returns:

The zero-based index of the column divider that was highlighted.

Remarks:

If a position is specified as well as a point, the point takes priority over the position.
Scrolling the control moves the header control, so that a point's listview coordinates (i. e. relative to the control's upper-left corner) don't necessarily equal the same point's header coordinates (i. e. relative to the header control's upper-left corner).

See also:

SetInsertMarkPosition, AllowHeaderDragDrop, RegisterForOLEDragDrop

HRESULT SetIconSpacing	(	[in] OLE_XSIZE_PIXELS	itemWidth,
		[in] OLE_YSIZE_PIXELS	itemHeight
	)

Sets the spacing between items in 'Icons' view

Sets an item's width and height (including the space beneath it) in 'Icons' view in pixels.

Parameters:

[in]	itemWidth	The item's width (including the space beneath it) in pixels.
[in]	itemHeight	The item's height (including the space beneath it) in pixels.

Remarks:

Setting both arguments to -1 resets icon spacing to the system defaults.

See also:

GetIconSpacing, JustifyIconColumns, View

HRESULT SetInsertMarkPosition	(	[in] InsertMarkPositionConstants	relativePosition,
		[in] IListViewItem *	listItem
	)

Sets the position of the control's insertion mark

Parameters:

[in]	relativePosition	The insertion mark's position relative to the specified item. Any of the values defined by the InsertMarkPositionConstants enumeration is valid.
[in]	listItem	The item at which to show the insertion mark. If set to Nothing, the insertion mark will be removed.

Remarks:

An insertion mark can be used only if the control is in 'Icons', 'Small Icons', 'Tiles' or 'Extended Tiles' view, is not in group-view mode, and has AutoArrangeItems set to aaiNormal.
Requires comctl32.dll version 6.0 or higher.

See also:

GetInsertMarkPosition, GetClosestInsertMarkPosition, SetHeaderInsertMarkPosition, InsertMarkColor, AutoArrangeItems, ShowGroups, View, RegisterForOLEDragDrop, InsertMarkPositionConstants

HRESULT ShowFooter

(

void

)

Displays the footer area

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

FooterIntroText, FooterItems, IsFooterVisible

HRESULT SortGroups	(	[in, defaultvalue(sobShell)] SortByConstants	firstCriterion,
		[in, defaultvalue(sobText)] SortByConstants	secondCriterion,
		[in, defaultvalue(sobNone)] SortByConstants	thirdCriterion,
		[in, defaultvalue(0)] VARIANT_BOOL	caseSensitive
	)

Sorts the control's groups

Sorts the control's groups by up to 3 criteria.

Parameters:

[in]	firstCriterion	The first criterion by which to sort. Some of the values defined by the SortByConstants enumeration is valid.
[in]	secondCriterion	The second criterion by which to sort. It is used if two groups are equivalent regarding the first criterion. Some of the values defined by the SortByConstants enumeration is valid.
[in]	thirdCriterion	The third criterion by which to sort. It is used if two groups are equivalent regarding the first 2 criteria. Some of the values defined by the SortByConstants enumeration is valid.
[in]	caseSensitive	If True, text comparisons will be case sensitive; otherwise not.

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

GroupSortOrder, _IExplorerListViewEvents::CompareGroups, SortItems, SortByConstants

HRESULT SortItems	(	[in, defaultvalue(sobShell)] SortByConstants	firstCriterion,
		[in, defaultvalue(sobText)] SortByConstants	secondCriterion,
		[in, defaultvalue(sobNone)] SortByConstants	thirdCriterion,
		[in, defaultvalue(sobNone)] SortByConstants	fourthCriterion,
		[in, defaultvalue(sobNone)] SortByConstants	fifthCriterion,
		[in, optional] VARIANT	column,
		[in, defaultvalue(0)] VARIANT_BOOL	caseSensitive
	)

Sorts the control's items

Sorts the control's items by up to 5 criteria.

Parameters:

[in]	firstCriterion	The first criterion by which to sort. Any of the values defined by the SortByConstants enumeration is valid.
[in]	secondCriterion	The second criterion by which to sort. It is used if two items are equivalent regarding the first criterion. Any of the values defined by the SortByConstants enumeration is valid.
[in]	thirdCriterion	The third criterion by which to sort. It is used if two items are equivalent regarding the first 2 criteria. Any of the values defined by the SortByConstants enumeration is valid.
[in]	fourthCriterion	The fourth criterion by which to sort. It is used if two items are equivalent regarding the first 3 criteria. Any of the values defined by the SortByConstants enumeration is valid.
[in]	fifthCriterion	The fifth criterion by which to sort. It is used if two items are equivalent regarding the first 4 criteria. Any of the values defined by the SortByConstants enumeration is valid.
[in]	column	The column by which to sort if sorting by (sub-)item text.
[in]	caseSensitive	If True, text comparisons will be case sensitive; otherwise not.

See also:

SortOrder, _IExplorerListViewEvents::CompareItems, SortGroups, SortByConstants

---

Property Documentation

VARIANT_BOOL AbsoluteBkImagePosition [get, set]

Controls the position of the control's background image

Retrieves or sets whether the position defined by the BkImagePositionX and BkImagePositionY properties is a relative one or an absolute one.
If set to True, both properties define the absolute offset (in pixels) of the top-left tile of the control's background image. Otherwise they're treaten as percentage values defining the background image's alignment relative to the control's client area. A value of 0 left-aligns (respectively top-aligns), 50 centers, 100 right-aligns (bottom-aligns) the background image and so on.

Remarks:

Requires comctl32.dll version 6.0 or higher.
If this property is set to True, the BkImageStyle property must be set to bisTiled.

See also:

BkImagePositionX, BkImagePositionY, BkImageStyle

VARIANT_BOOL AllowHeaderDragDrop [get, set]

Specifies whether the control detects column drag'n'drop operations

Retrieves or sets whether the control's columns can be reordered by drag'n'dropping the column headers. If set to True, columns can be reordered; otherwise not.

See also:

RegisterForOLEDragDrop, DragScrollTimeBase, SetHeaderInsertMarkPosition, IListViewColumn::Position, _IExplorerListViewEvents::ColumnBeginDrag

VARIANT_BOOL AllowLabelEditing [get, set]

Specifies whether label-editing mode can be entered

Retrieves or sets whether label-editing mode can be entered. If set to True, label-edit mode can be entered by either calling IListViewItem::StartLabelEditing or by single-clicking a selected item. If set to False, label-edit mode is not available.

See also:

hWndEdit, IListViewItem::StartLabelEditing, _IExplorerListViewEvents::StartingLabelEditing

VARIANT_BOOL AlwaysShowSelection [get, set]

Controls how the selected item is displayed

Retrieves or sets whether the selected items are highlighted even if the control doesn't have the focus. If set to True, selected items are drawn as selected if the control does not have the focus; otherwise they're drawn as normal items.

See also:

CaretItem, IListViewItem::Selected

IListViewItem AnchorItem [get, set]

Specifies the control's selection anchor item

Retrieves or sets the control's anchor item. The anchor item is the item with which range-selection begins.

See also:

IListViewItem::Anchor, MultiSelect, CaretItem

AppearanceConstants Appearance [get, set]

Controls the style of the control's outer border

Retrieves or sets the kind of border that is drawn around the control. Any of the values defined by the AppearanceConstants enumeration is valid.

See also:

BorderStyle, AppearanceConstants

AutoArrangeItemsConstants AutoArrangeItems [get, set]

Controls arrangement of the control's items

Retrieves or sets how the control auto-arranges its items in 'Icons', 'Small Icons', 'Tiles' and 'Extended Tiles' view. Any of the values defined by the AutoArrangeItemsConstants enumeration is valid.

See also:

View, ArrangeItems, SnapToGrid, UseWorkAreas, WorkAreas, AutoArrangeItemsConstants

VARIANT_BOOL AutoSizeColumns [get, set]

Controls automatic column resizing

Retrieves or sets whether the other columns are sized automatically to optimally fill the available space if one column is resized by the user. If set to True, the columns are sized automatically; otherwise not.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

Columns, IListViewColumn::Width

OLE_COLOR BackColor [get, set]

Specifies the control's background color

Retrieves or sets the control's background color.

See also:

BkImage, BackgroundDrawMode, ForeColor, TextBackColor, EditBackColor, InsertMarkColor

BackgroundDrawModeConstants BackgroundDrawMode [get, set]

Controls how the control's background is drawn

Retrieves or sets how the control's background is drawn. Any of the values defined by the BackgroundDrawModeConstants enumeration is valid.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

BackColor, BkImage, Regional, BackgroundDrawModeConstants

VARIANT BkImage [get, set]

Specifies the control's background image

Retrieves or sets the control's background image. Valid values are:

• A string containing the image's URL. Use the res:// protocol to load an image from a binary's resources.
• A StdPicture object containg the image (requires comctl32.dll version 6.0 or higher).
• The bitmap's handle (requires comctl32.dll version 6.0 or higher).
• Empty if the control doesn't have a background image.

See also:

BkImageStyle, BkImagePositionX, BkImagePositionY, BackColor, BackgroundDrawMode, TextBackColor

LONG BkImagePositionX [get, set]

Controls the position of the control's background image

Retrieves or sets the x-coordinate of the position of the control's background bitmap. Depending on the setting of the AbsoluteBkImagePosition property, the value is either an absolute pixel value or a relative percentage value.

See also:

AbsoluteBkImagePosition, BkImagePositionY, BkImage

LONG BkImagePositionY [get, set]

Controls the position of the control's background image

Retrieves or sets the y-coordinate of the position of the control's background bitmap. Depending on the setting of the AbsoluteBkImagePosition property, the value is either an absolute pixel value or a relative percentage value.

See also:

AbsoluteBkImagePosition, BkImagePositionX, BkImage

BkImageStyleConstants BkImageStyle [get, set]

Controls the appearance of the control's background image

Retrieves or sets how the control's background image is drawn. Any of the values defined by the BkImageStyleConstants enumeration is valid.

See also:

BkImage, BkImagePositionX, BkImagePositionY, BkImageStyleConstants

VARIANT_BOOL BlendSelectionLasso [get, set]

Controls the appearance of the control's selection lasso

Retrieves or sets whether the selection lasso will be drawn as a semi-transparent filled rectangle. If set to True, the selection lasso is drawn as a filled rectangle with a solid border; otherwise only the border is drawn (as a dotted line).

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

MultiSelect, _IExplorerListViewEvents::BeginMarqueeSelection

VARIANT_BOOL BorderSelect [get, set]

Controls the appearance of selected items

Retrieves or sets how selected items are drawn. If set to True, selected items are surrounded by a rectangular border in the system's highlight color; otherwise they are blended with the system's highlight color. Unselected items are surrounded by a rectangular border that has the color defined by the OutlineColor property, if this property is set to True.

Remarks:

This property is useful with the 'Icons' view only.
Requires comctl32.dll version 5.80 or higher.

See also:

OutlineColor, View

BorderStyleConstants BorderStyle [get, set]

Controls the style of the control's inner border

Retrieves or sets the kind of inner border that is drawn around the control. Any of the values defined by the BorderStyleConstants enumeration is valid.

See also:

Appearance, BorderStyleConstants

CallBackMaskConstants CallBackMask [get, set]

Controls when the ItemGetDisplayInfo event is fired

Retrieves or sets the item properties for which your application, rather than the control, stores the current data. The callback mask applies to all of the control's items.
Any combination of the values defined by the CallBackMaskConstants enumeration is valid. The control will fire the ItemGetDisplayInfo event each time one of the callback properties' value is required.

See also:

_IExplorerListViewEvents::ItemGetDisplayInfo, CallBackMaskConstants

IListViewColumn CaretColumn [get, set]

Specifies the control's caret column header

Retrieves or sets the control's caret column header. The caret column header is the column header that has the focus.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

SelectedColumn, IListViewColumn::Caret, SetFocusToHeader

IListViewFooterItem CaretFooterItem [get, set]

Specifies the control's caret footer item

Retrieves or sets the control's caret footer item. The caret footer item is the footer item that has the focus.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

IListViewFooterItem::Caret

IListViewGroup CaretGroup [get, set]

Specifies the control's caret group

Retrieves or sets the control's caret group. The caret group is the group that has the focus.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

IListViewGroup::Caret

IListViewItem CaretItem [get, set]

Specifies the control's caret item

Retrieves or sets the control's caret item. The caret item is the item that has the focus.

Parameters:

[in]

changeFocusOnly

If set to True, the method does nothing more than setting the focus to the specified item. The items' selection states are not changed. If set to False, the selection states are changed, too. This parameter is ignored when retrieving the caret item.

Remarks:

ChangeFocusOnly must be set to True, if the VirtualMode property is set to True.
This is the control's default property.

See also:

IListViewItem::Caret, MultiSelect, AnchorItem, VirtualMode

VARIANT_BOOL CheckItemOnSelect [get, set]

Specifies whether selecting an item changes its state image

Retrieves or sets whether selecting an item using the mouse sets its state image to 'Checked'. If set to True, selecting an item changes its state image; otherwise not. Also state images are invisible by default and displayed only for selected items and the item below the mouse cursor, if this property is set to True.

Remarks:

The ShowHeaderStateImages property is overridden by this property. If CheckItemOnSelect is set to True, ShowHeaderStateImages is also set to True automatically. After CheckItemOnSelect has been changed from False to True, ShowHeaderStateImages can't be set to True alone until the control window is recreated.
Requires comctl32.dll version 6.10 or higher.

See also:

ShowStateImages, ShowHeaderStateImages

VARIANT_BOOL ClickableColumnHeaders [get, set]

Specifies whether the control's column headers are button-like

Retrieves or sets whether the control's column headers act like buttons and are clickable. If set to True, the headers can be clicked; otherwise not.

See also:

SelectedColumn, hWndHeader, View, Columns, IListViewColumn::SortArrow

ColumnHeaderVisibilityConstants ColumnHeaderVisibility [get, set]

Controls the visibility of the column headers

Retrieves or sets the conditions under which the column headers are displayed. Any of the values defined by the DisabledEventsConstants enumeration is valid.

See also:

Columns, ColumnHeaderVisibilityConstants

IListViewColumns Columns [get]

Retrieves the control's columns

Retrieves a collection object wrapping the control's columns.

Remarks:

This property is read-only.

See also:

SelectedColumn, IListViewColumns

OLE_XSIZE_PIXELS ColumnWidth [get, set]

Specifies the column width in 'List' view

Retrieves or sets the width (in pixels) of a column in 'List' view.

Remarks:

The control must not be in 'Details' view when you call this property.
This property can't be set at design-time.

See also:

IListViewColumn::Width, IExplorerListView::GetStringWidth, View

DisabledEventsConstants DisabledEvents [get, set]

Controls which events are fired

Retrieves or sets the events that won't be fired. Disabling events increases performance. Any combination of the values defined by the DisabledEventsConstants enumeration is valid.

See also:

DisabledEventsConstants

VARIANT_BOOL DontRedraw [get, set]

Controls redrawing of the control

Enables or disables automatic redrawing of the control. Disabling redraw while doing large changes on the listview (like adding many items) may increase performance. If set to False, the control will redraw itself automatically; otherwise not.

IListViewColumn DraggedColumn [get]

Retrieves the column currently dragged

Retrieves the column that is currently dragged. This is the same column that was passed to the HeaderBeginDrag or HeaderOLEDrag method.

Remarks:

This property is read-only.

See also:

HeaderBeginDrag, HeaderOLEDrag, Columns, DraggedItems, _IExplorerListViewEvents::ColumnBeginDrag

IListViewItemContainer DraggedItems [get]

Retrieves the items currently dragged

Retrieves a collection object wrapping the items that are currently dragged. These are the same items that were passed to the BeginDrag or OLEDrag method.

Remarks:

This property is read-only.

See also:

BeginDrag, OLEDrag, IListViewItemContainer, ListItems, DraggedColumn

LONG DragScrollTimeBase [get, set]

Controls the speed of automatic scrolling during drag'n'drop

Retrieves or sets the period of time (in milliseconds) that is used as the time-base to calculate the velocity of auto-scrolling during a drag'n'drop operation. If set to 0, auto-scrolling is disabled. If set to -1, the system's double-click time, divided by 4, is used.

See also:

AllowHeaderDragDrop, RegisterForOLEDragDrop, _IExplorerListViewEvents::DragMouseMove, _IExplorerListViewEvents::HeaderDragMouseMove, _IExplorerListViewEvents::OLEDragMouseMove, _IExplorerListViewEvents::HeaderOLEDragMouseMove

VARIANT_BOOL DrawImagesAsynchronously [get, set]

Controls the control's asynchronous drawing features

Retrieves or sets whether the control draws the items' and groups' associated images asynchronously. Asynchronous image drawing may improve performance. If set to True, item and group images are drawn asynchronously; otherwise not.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

hImageList, _IExplorerListViewEvents::ItemAsynchronousDrawFailed, _IExplorerListViewEvents::GroupAsynchronousDrawFailed

IListViewItem DropHilitedItem [get, set]

Specifies the item that currently is the drop target

Retrieves or sets the item, that is the target of a drag'n'drop operation. Its background is drawn highlighted. If set to Nothing, no item is a drop target.

See also:

IListViewItem::DropHilited, RegisterForOLEDragDrop, CaretItem, _IExplorerListViewEvents::DragMouseMove, _IExplorerListViewEvents::OLEDragMouseMove

OLE_COLOR EditBackColor [get, set]

Specifies the contained edit control's background color

Retrieves or sets the contained edit control's background color.

See also:

EditForeColor, BackColor

OLE_COLOR EditForeColor [get, set]

Specifies the contained edit control's text color

Retrieves or sets the contained edit control's text color.

See also:

EditBackColor, ForeColor

LONG EditHoverTime [get, set]

Controls when the EditMouseHover event is fired

Retrieves or sets the number of milliseconds the mouse cursor must be located over the contained edit control's client area before the EditMouseHover event is fired. If set to -1, the system hover time is used.

See also:

_IExplorerListViewEvents::EditMouseHover, HoverTime, HeaderHoverTime

IMEModeConstants EditIMEMode [get, set]

Controls the control's IME features

Retrieves or sets the contained edit control's IME mode. IME is a Windows feature making it easy to enter Asian characters. Any of the values defined by the IMEModeConstants enumeration is valid.

See also:

IMEMode, IMEModeConstants

BSTR EditText [get, set]

Specifies the contained edit control's content

Retrieves or sets the text displayed by the contained edit control.

See also:

IListViewItem::Text, _IExplorerListViewEvents::EditChange

BSTR EmptyMarkupText [get, set]

Specifies the text that is displayed if the control does not contain any items

Retrieves or sets the text that the control will display if it contains no items.
Comctl32.dll version 6.10 and newer only: Any <a> tags in the text are converted to links. So to make the word Click in the text Click here to add an item clickable, set the EmptyMarkupText property to <a>Click</a> here to add an item. You can define more than one link. If the user clicks such a link, the event EmptyMarkupTextLinkClick will be raised.

Remarks:

The text's maximum length is 79 characters for comctl32.dll version 6.00 and older and 2083 characters for comctl32.dll version 6.10 and higher.
You should set the ShowFilterBar property to False, if you want to use this property.
Requires comctl32.dll version 5.80 or higher.

See also:

EmptyMarkupTextAlignment, _IExplorerListViewEvents::EmptyMarkupTextLinkClick, ShowFilterBar, ListItems

AlignmentConstants EmptyMarkupTextAlignment [get, set]

Specifies the alignment of the text that is displayed if the control does not contain any items

Retrieves or sets the alignment of the text that is displayed if the control does not contain any items. Any of the values defined by the AlignmentConstants enumeration except alRight is valid.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

EmptyMarkupText, AlignmentConstants

VARIANT_BOOL Enabled [get, set]

Controls whether the control accepts user input

Enables or disables the control for user input. If set to True, it reacts to user input; otherwise not.

LONG FilterChangedTimeout [get, set]

Controls when the FilterChanged event is fired

Retrieves or sets the number of milliseconds, that will pass before the FilterChanged event is fired after a column's filter was changed. If set to -1, the system's default setting is used.

Remarks:

Requires comctl32.dll version 5.80 or higher.

See also:

_IExplorerListViewEvents::FilterChanged, ShowFilterBar

IListViewItem FirstVisibleItem [get]

Retrieves the control's first item that is displayed in the control's client area

Retrieves the first listview item, that is entirely located within the control's client area and therefore visible to the user. This applies to 'List' and 'Details' view only.

Remarks:

This property is read-only.

See also:

ListItems, View

IFontDisp Font [get, set]

Specifies the control's font

Retrieves or sets the control's font. It's used to draw the items' text.

See also:

UseSystemFont, ForeColor, IListViewItem::Text

BSTR FooterIntroText [get, set]

Specifies the text that is displayed in the footer area's caption

Retrieves or sets the text that the control will display in the footer area's caption.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

FooterItems, ShowFooter

IListViewFooterItems FooterItems [get]

Retrieves the control's footer items

Retrieves a collection object wrapping the control's footer items.

Remarks:

Requires comctl32.dll version 6.10 or higher.
This property is read-only.

See also:

ShowFooter, IListViewFooterItems, hImageList

OLE_COLOR ForeColor [get, set]

Specifies the control's text color

Retrieves or sets the control's text color.

See also:

BackColor, TextBackColor, HotForeColor, EditForeColor, InsertMarkColor

FullRowSelectConstants FullRowSelect [get, set]

Controls the control's selection style

Retrieves or sets whether an item's entire row (in 'Details' view) is highlighted if it is selected. Any of the values defined by the FullRowSelectConstants enumeration is valid.

See also:

View, FullRowSelectConstants

VARIANT_BOOL GridLines [get, set]

Specifies whether gridlines are drawn in 'Details' view

Retrieves or sets whether the control draws gridlines in 'Details' view. If set to True, gridlines are drawn; otherwise not.

See also:

View

OLE_COLOR GroupFooterForeColor [get, set]

Specifies the control's group footer text color

Retrieves or sets the color that the footer texts of the control's groups are drawn in.

Remarks:

Requires comctl32.dll version 6.10 or higher.
This property isn't supported for themed listviews.

See also:

GroupHeaderForeColor, Groups, ForeColor, IListViewGroup::Text

OLE_COLOR GroupHeaderForeColor [get, set]

Specifies the control's group header text color

Retrieves or sets the color that the header texts of the control's groups are drawn in.

Remarks:

Requires comctl32.dll version 6.0 or higher.
Comctl32.dll version 6.10 or higher doesn't support this property for themed listviews.

See also:

GroupFooterForeColor, Groups, ForeColor, IListViewGroup::Text

OLE_YSIZE_PIXELS GroupMarginBottom [get, set]

Specifies the control's group bottom margin

Retrieves or sets the bottom margin (in pixels) of the control's groups.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

GroupMarginLeft, GroupMarginRight, GroupMarginTop, Groups

OLE_XSIZE_PIXELS GroupMarginLeft [get, set]

Specifies the control's group left margin

Retrieves or sets the left margin (in pixels) of the control's groups.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

GroupMarginBottom, GroupMarginRight, GroupMarginTop, Groups

OLE_XSIZE_PIXELS GroupMarginRight [get, set]

Specifies the control's group right margin

Retrieves or sets the right margin (in pixels) of the control's groups.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

GroupMarginBottom, GroupMarginLeft, GroupMarginTop, Groups

OLE_YSIZE_PIXELS GroupMarginTop [get, set]

Specifies the control's group top margin

Retrieves or sets the top margin (in pixels) of the control's groups.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

GroupMarginBottom, GroupMarginLeft, GroupMarginRight, Groups

IListViewGroups Groups [get]

Retrieves the control's groups

Retrieves a collection object wrapping the control's groups.

Remarks:

Requires comctl32.dll version 6.0 or higher.
This property is read-only.

See also:

ShowGroups, IListViewGroups, IListViewItem::Group, hImageList

SortOrderConstants GroupSortOrder [get, set]

Specifies the control's group sorting direction

Retrieves or sets the direction groups are sorted in. Any of the values defined by the SortOrderConstants enumeration is valid.

See also:

SortGroups, SortOrderConstants

OLE_HANDLE hDragImageList [get]

Retrieves the imagelist containing the drag image

Retrieves the handle to the imagelist containing the drag image that is used during a drag'n'drop operation to visualize the dragged items or column header.

See also:

ShowDragImage, BeginDrag, HeaderBeginDrag, _IExplorerListViewEvents::DragMouseMove, _IExplorerListViewEvents::HeaderDragMouseMove

VARIANT_BOOL HeaderFullDragging [get, set]

Specifies the appearance of columns while they are resized

Retrieves or sets whether a column's caption and content are redrawn while the user is resizing the column. If set to True, the column is redrawn immediately; otherwise it is redrawn when leaving column resize mode.

See also:

AllowHeaderDragDrop, View

VARIANT_BOOL HeaderHotTracking [get, set]

Controls the control's mouse-hover effects

Retrieves or sets whether the caption of the column header underneath the mouse cursor is highlighted. If set to True, the caption is highlighted; otherwise not.

Remarks:

This property has no effect if the header control is themed.

See also:

View

LONG HeaderHoverTime [get, set]

Controls when the HeaderMouseHover event is fired

Retrieves or sets the number of milliseconds the mouse cursor must be located over the header control's client area before the HeaderMouseHover event is fired. If set to -1, the system hover time is used.

See also:

_IExplorerListViewEvents::HeaderMouseHover, HoverTime, EditHoverTime

OLEDragImageStyleConstants HeaderOLEDragImageStyle [get, set]

Specifies the appearance of the OLE drag images generated by the control

Retrieves or sets the appearance of the OLE drag images generated by the control for column header OLE drag'n'drop. Any of the values defined by the OLEDragImageStyleConstants enumeration is valid.

See also:

OLEDragImageStyle, SupportOLEDragImages, HeaderOLEDrag, OLEDragImageStyleConstants

VARIANT_BOOL HideLabels [get, set]

Specifies the visibility of item labels

Retrieves or sets whether the control displays item-labels in 'Icons' and 'Small Icons' view. If set to False, item-labels are displayed; otherwise not.

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

TextBackColor, LabelWrap, View

OLE_HANDLE hImageList [get, set]

Specifies one of the control's associated image list

Retrieves or sets the handle of the specified image list.

Parameters:

[in]

imageList

The image list to retrieve or set. Any of the values defined by the ImageListConstants enumeration is valid.

Remarks:

The previous image list does NOT get auto-destroyed.

See also:

ImageListConstants

OLE_COLOR HotForeColor [get, set]

Specifies the control's text color for hot items

Retrieves or sets the control's text color for hot items. If set to -1, the system's default is used.

See also:

ForeColor, HotItem

IListViewItem HotItem [get, set]

Specifies the control's hot item

Retrieves or sets the control's hot item. Usually the hot item is underlined and/or highlighted. If set to Nothing, the control does not have a hot item.

Remarks:

You should set the ItemActivationMode property to iamOneSingleClick or iamTwoSingleClicks and the UnderlinedItems property should include uiHot, if you want to use this property.

See also:

ItemActivationMode, UnderlinedItems, IListViewItem::Hot, HotForeColor, _IExplorerListViewEvents::HotItemChanging, _IExplorerListViewEvents::HotItemChanged

IPictureDisp HotMouseIcon [get, set]

Controls the control's mouse cursor

Retrieves or sets a user-defined mouse cursor. It's used if HotMousePointer is set to mpCustom and the mouse cursor is located over a hot item.

Remarks:

The ItemActivationMode property must be set to iamOneSingleClick or iamTwoSingleClicks, if you want to use a non-default hot mouse cursor.

See also:

HotMousePointer, HotTracking, ItemActivationMode, MouseIcon, MousePointerConstants

MousePointerConstants HotMousePointer [get, set]

Controls the control's mouse cursor

Retrieves or sets the cursor's type that's used if the mouse cursor is placed over an item that has the 'Hot' attribute being set. Any of the values defined by the MousePointerConstants enumeration is valid.

Remarks:

The ItemActivationMode property must be set to iamOneSingleClick or iamTwoSingleClicks, if you want to use a non-default hot mouse cursor.

See also:

HotMouseIcon, HotTracking, ItemActivationMode, MousePointer, MousePointerConstants

VARIANT_BOOL HotTracking [get, set]

Controls the control's mouse-hover effects

Retrieves or sets whether the item underneath the mouse cursor is selected automatically. If set to True, the item is selected automatically; otherwise not.

See also:

HotTrackingHoverTime, HotItem, HotMousePointer, HotMouseIcon, ItemActivationMode, UnderlinedItems, _IExplorerListViewEvents::HotItemChanging, _IExplorerListViewEvents::HotItemChanged

LONG HotTrackingHoverTime [get, set]

Controls automatic item selection in hot-tracking mode

Retrieves or sets the number of milliseconds the mouse cursor must be located over an item before it is selected (if HotTracking is activated). If set to -1, the system's default setting is used.

See also:

HotTracking, HotItem, HoverTime

LONG HoverTime [get, set]

Controls when the MouseHover event is fired

Retrieves or sets the number of milliseconds the mouse cursor must be located over the control's client area before the MouseHover event is fired. If set to -1, the system hover time is used.

See also:

_IExplorerListViewEvents::MouseHover, HotTrackingHoverTime, HeaderHoverTime, EditHoverTime

OLE_HANDLE hWnd [get]

Retrieves the control's window handle

Retrieves the control's window handle.

Remarks:

This property is read-only.

See also:

hWndEdit, hWndHeader, _IExplorerListViewEvents::RecreatedControlWindow, _IExplorerListViewEvents::DestroyedControlWindow

OLE_HANDLE hWndEdit [get]

Retrieves the contained edit control's window handle

Retrieves the contained edit control's window handle.

Remarks:

This property is read-only.

See also:

hWnd, hWndHeader, _IExplorerListViewEvents::CreatedEditControlWindow, _IExplorerListViewEvents::DestroyedEditControlWindow

OLE_HANDLE hWndHeader [get]

Retrieves the contained header control's window handle

Retrieves the contained header control's window handle.

Remarks:

This property is read-only.

See also:

hWnd, hWndEdit, _IExplorerListViewEvents::CreatedHeaderControlWindow, _IExplorerListViewEvents::DestroyedHeaderControlWindow

OLE_HANDLE hWndToolTip [get, set]

Specifies the tooltip control's window handle

Retrieves or sets the tooltip control's window handle.

Remarks:

The previous tooltip window does NOT get auto-destroyed.

See also:

ToolTips

IMEModeConstants IMEMode [get, set]

Controls the control's IME features

Retrieves or sets the control's IME mode. IME is a Windows feature making it easy to enter Asian characters. Any of the values defined by the IMEModeConstants enumeration is valid.

See also:

EditIMEMode, IMEModeConstants

VARIANT_BOOL IncludeHeaderInTabOrder [get, set]

Specifies whether the keyboard focus can be set to the header control by pressing the [TAB] key

Retrieves or sets whether the header control is included in the tab order, so that the keyboard focus can be set to it by pressing the [TAB] key. If set to True, the header control is part of the tab order; otherwise not.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

_IExplorerListViewEvents::HeaderGotFocus, _IExplorerListViewEvents::HeaderLostFocus

BSTR IncrementalSearchString [get]

Retrieves the control's current incremental search-string

Retrieves the control's current incremental search-string. This string is used to select an item based on characters entered by the user.

Remarks:

This property is read-only.

See also:

_IExplorerListViewEvents::IncrementalSearchStringChanging, _IExplorerListViewEvents::IncrementalSearching

OLE_COLOR InsertMarkColor [get, set]

Specifies the color of the control's insertion mark

Retrieves or sets the color that the control's insertion mark is drawn in.

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

SetInsertMarkPosition, BackColor, ForeColor

ItemActivationModeConstants ItemActivationMode [get, set]

Controls when the ItemActivate event is fired

Retrieves or sets the circumstances under which the control will fire the ItemActivate event. Any of the values defined by the ItemActivationModeConstants enumeration is valid.

See also:

HotTracking, UnderlinedItems, _IExplorerListViewEvents::ItemActivate, IListViewItem::Activating, IListViewSubItem::Activating, ItemActivationModeConstants

ItemAlignmentConstants ItemAlignment [get, set]

Controls alignment of the control's items

Retrieves or sets how items are aligned in 'Icons', 'Small Icons', 'Tiles' and 'Extended Tiles' view. Any of the values defined by the ItemAlignmentConstants enumeration is valid.

Remarks:

This property should be set to iaTop if ShowGroups is set to True.

See also:

View, ItemAlignmentConstants

ItemBoundingBoxDefinitionConstants ItemBoundingBoxDefinition [get, set]

Specifies which parts of an item are handled as such

Retrieves or sets the parts of an item that get handled as such if firing any kind of mouse event. Any combination of the values defined by the ItemBoundingBoxDefinitionConstants enumeration is valid. E. g. if set to ibbdItemIcon combined with ibbdItemStateImage, the listItem parameter of the MouseMove event will identify the item only if the mouse cursor is located over the item's icon or state image; otherwise (e. g. if the cursor is located over the item's text) it will be Nothing.

See also:

HitTest, ItemBoundingBoxDefinitionConstants

OLE_YSIZE_PIXELS ItemHeight [get, set]

Specifies the items' height

Retrieves or sets the items' height in pixels. This setting is used in 'Details' view if the OwnerDrawn property is set to True.

See also:

OwnerDrawn, View, IListViewItem::GetRectangle

VARIANT_BOOL JustifyIconColumns [get, set]

Controls the spacing between items in 'Icons' view

Retrieves or sets whether icon spacing may be adjusted automatically by some pixels so that the available space is filled up optimally. If set to True, horizontal icon spacing is adjusted automatically; otherwise not.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

SetIconSpacing, View

VARIANT_BOOL LabelWrap [get, set]

Controls the appearance of item labels

Retrieves or sets whether an item's text may be wrapped in 'Icons' view. If set to True, it may be wrapped; otherwise not.

See also:

HideLabels, View

IListViewItems ListItems [get]

Retrieves the control's items

Retrieves a collection object wrapping the listview items.

Remarks:

This property is read-only.

See also:

IListViewItems

LONG MinItemRowsVisibleInGroups [get, set]

Specifies the number of item rows visible in subseted groups

Retrieves or sets the number of item rows that are always displayed in subseted groups. If set to 0, the control always displays all of the groups' items.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

IListViewGroup::Subseted

IPictureDisp MouseIcon [get, set]

Controls the control's mouse cursor

Retrieves or sets a user-defined mouse cursor. It's used if MousePointer is set to mpCustom.

See also:

MousePointer, HotMouseIcon, MousePointerConstants

MousePointerConstants MousePointer [get, set]

Controls the control's mouse cursor

Retrieves or sets the cursor's type that's used if the mouse cursor is placed within the control's client area. Any of the values defined by the MousePointerConstants enumeration is valid.

See also:

MouseIcon, HotMousePointer, MousePointerConstants

VARIANT_BOOL MultiSelect [get, set]

Specifies whether multiple items can be selected

Retrieves or sets whether multiple items can be selected at the same time. If set to True, the user may select multiple items; otherwise not.

See also:

BlendSelectionLasso, _IExplorerListViewEvents::BeginMarqueeSelection

OLEDragImageStyleConstants OLEDragImageStyle [get, set]

Specifies the appearance of the OLE drag images generated by the control

Retrieves or sets the appearance of the OLE drag images generated by the control. Any of the values defined by the OLEDragImageStyleConstants enumeration is valid.

See also:

HeaderOLEDragImageStyle, SupportOLEDragImages, OLEDrag, OLEDragImageStyleConstants

OLE_COLOR OutlineColor [get, set]

Controls the appearance of unselected items

Retrieves or sets the color, that the rectangular border is drawn in, that surrounds an unselected item if BorderSelect is set to True.

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

BorderSelect

VARIANT_BOOL OwnerDrawn [get, set]

Specifies whether the items are drawn by the application instead of the control

Retrieves or sets whether your application draws the items itself in 'Details' view. If set to True, the control will fire the OwnerDrawItem event each time an item must be drawn in 'Details' view. If set to False, the control will draw the items itself. In this case drawing can still be customized using the CustomDraw event.

See also:

ItemHeight, View, _IExplorerListViewEvents::OwnerDrawItem, _IExplorerListViewEvents::CustomDraw, IListViewColumn::OwnerDrawn

VARIANT_BOOL ProcessContextMenuKeys [get, set]

Specifies whether the ContextMenu event can be invoked using the keyboard

Retrieves or sets whether the control fires the ContextMenu, HeaderContextMenu and EditContextMenu events if the user presses [SHIFT]+[F10] or [WINDOWS CONTEXTMENU]. If set to True, the events are fired; otherwise not.

See also:

_IExplorerListViewEvents::ContextMenu, _IExplorerListViewEvents::HeaderContextMenu, _IExplorerListViewEvents::EditContextMenu

VARIANT_BOOL Regional [get, set]

Controls the control's window region

Retrieves or sets whether the control's window region includes only the item icons and text in 'Icons' view. Any area, that is not part of an item, is excluded from the window region. If set to True, the control's window region contains only items; otherwise it contains the whole client area.

See also:

BackgroundDrawMode, View

VARIANT_BOOL RegisterForOLEDragDrop [get, set]

Controls the control's behavior in drag'n'drop operations

Retrieves or sets whether the control is registered as a target for OLE drag'n'drop. If set to True, the control accepts OLE drag'n'drop actions; otherwise not.

See also:

SupportOLEDragImages, _IExplorerListViewEvents::OLEDragEnter, _IExplorerListViewEvents::HeaderOLEDragEnter

VARIANT_BOOL ResizableColumns [get, set]

Specifies whether the control's columns can be resized

Retrieves or sets whether the user can resize the control's columns. If set to True, the columns can be resized; otherwise not.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

IListViewColumn::Resizable, IListViewColumn::Width, _IExplorerListViewEvents::BeginColumnResizing

RightToLeftConstants RightToLeft [get, set]

Controls the control's right-to-left features

Enables or disables bidirectional features. Any combination of the values defined by the RightToLeftConstants enumeration is valid.

Attention:

Setting or clearing the rtlText flag destroys and recreates the control window.

See also:

IMEMode, RightToLeftConstants

ScrollBarsConstants ScrollBars [get, set]

Specifies the scrollbars to show

Retrieves or sets the scrollbars to show if necessary. Any of the values defined by the ScrollBarsConstants enumeration is valid.

Attention:

Changing this property may destroy and recreate the control window.

See also:

_IExplorerListViewEvents::BeforeScroll, _IExplorerListViewEvents::AfterScroll, ScrollBarsConstants

IListViewColumn SelectedColumn [get, set]

Specifies the control's selected column

Retrieves or sets the control's selected column. The selected column is highlighted.

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

SelectedColumnBackColor, CaretColumn, IListViewColumn::Selected, IListViewColumn::SortArrow, View

OLE_COLOR SelectedColumnBackColor [get, set]

Specifies the selected column's background color

Retrieves or sets the background color of the control's selected column. If set to -1, the system's default is used.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

SelectedColumn, BackColor, ForeColor

VARIANT_BOOL ShowDragImage [get, set]

Controls the visibility of the control's drag image

Retrieves or sets whether the drag image is currently visible or hidden. If set to True, it is visible; otherwise it is hidden.

See also:

hDragImageList, SupportOLEDragImages, _IExplorerListViewEvents::DragMouseMove, _IExplorerListViewEvents::HeaderDragMouseMove

VARIANT_BOOL ShowFilterBar [get, set]

Specifies whether the control's header control is extended by a filter bar

Retrieves or sets whether the control's header control contains a filter bar in 'Details' view. If set to True, it contains a filter bar; otherwise not.

Remarks:

Requires comctl32.dll version 5.80 or higher.

See also:

hWndHeader, View, IListViewColumn::Filter

VARIANT_BOOL ShowGroups [get, set]

Specifies whether the control's items are organized in groups

Retrieves or sets whether the control organizes its items in groups. If set to True, item groups are drawn; otherwise not.

Remarks:

The 'List' view doesn't support groups.
This property should be set to False if ItemAlignment is set to iaLeft.
This property should be set to False if you want to use working areas.
Requires comctl32.dll version 6.0 or higher.

See also:

Groups, View, ItemAlignment, WorkAreas, IListViewItem::Group

VARIANT_BOOL ShowHeaderChevron [get, set]

Specifies whether the header control displays a chevron if not all column headers can be displayed

Retrieves or sets whether the control's header control displays a chevron button if the column headers are wider than the control and therefore can't be displayed all together. If set to True, a chevron is drawn; otherwise not.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

GetHeaderChevronRectangle, IListViewColumn::Width, _IExplorerListViewEvents::HeaderChevronClick

VARIANT_BOOL ShowHeaderStateImages [get, set]

Specifies whether the control draws state images into the column headers

Retrieves or sets whether the control draws a state image (usually a checkbox) to the left of each column header's caption. If set to True, the state images are drawn; otherwise not.

Remarks:

The CheckItemOnSelect property overriddes this property. If CheckItemOnSelect is set to True, ShowHeaderStateImages is also set to True automatically. After CheckItemOnSelect has been changed from False to True, ShowHeaderStateImages can't be set to True alone until the control window is recreated.
Requires comctl32.dll version 6.10 or higher.

See also:

hImageList, IListViewColumn::StateImageIndex, ShowStateImages, CheckItemOnSelect

VARIANT_BOOL ShowStateImages [get, set]

Specifies whether the control draws state images next to the items

Retrieves or sets whether the control draws a state image (usually a checkbox) to the left of each item. If set to True, the state images are drawn; otherwise not.

Remarks:

With comctl32.dll version 6.0 state images aren't fully supported in 'Tiles' view, i. e. you can't toggle them using the mouse.

See also:

hImageList, IListViewItem::StateImageIndex, SimpleSelect, CheckItemOnSelect, ShowHeaderStateImages, View

VARIANT_BOOL ShowSubItemImages [get, set]

Specifies whether the control draws state images next to the sub-items

Retrieves or sets whether the control will draw icons for sub-items in 'Details' view. If set to True, sub-item images will be drawn; otherwise not.

See also:

hImageList, IListViewSubItem::IconIndex, View

VARIANT_BOOL SimpleSelect [get, set]

Controls state image changing

Retrieves or sets whether pressing the spacebar changes the state image for all selected items or only for the item that has the focus. If set to True, all selected items, otherwise only the focused item will be updated.

Remarks:

If this property is set to True and the state image is toggled using the keyboard, the state image will be updated for all selected items, but the ItemStateImageChanging and ItemStateImageChanged events will be raised for the caret item only.
Requires comctl32.dll version 6.0 or higher.

See also:

ShowStateImages, hImageList, MultiSelect,_IExplorerListViewEvents::ItemStateImageChanging, _IExplorerListViewEvents::ItemStateImageChanged

VARIANT_BOOL SingleRow [get, set]

Controls arrangement of the control's items

Retrieves or sets whether items are arranged in a single row or column (depending on the setting for the ItemAlignment property) in 'Icons' and 'Small Icons' view. If set to True, a single, otherwise multiple rows/columns are used to display the items.

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

ItemAlignment, View

VARIANT_BOOL SnapToGrid [get, set]

Controls positioning of the control's items

Retrieves or sets whether items are automatically snapped to the nearest grid position in 'Icons', 'Small Icons', 'Tiles' and 'Extended Tiles' view. If set to True, items are snapped to the nearest grid position; otherwise they can be positioned freely (if the AutoArrangeItems property is not set to aaiNormal).

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

AutoArrangeItems, View, ArrangeItems, IListViewItem::SetPosition

SortOrderConstants SortOrder [get, set]

Specifies the control's sorting direction

Retrieves or sets the direction items are sorted in. Any of the values defined by the SortOrderConstants enumeration is valid.

See also:

SortItems, SortOrderConstants, _IExplorerListViewEvents::ChangingSortOrder, _IExplorerListViewEvents::ChangedSortOrder

VARIANT_BOOL SupportOLEDragImages [get, set]

Controls the control's behavior in drag'n'drop operations

Retrieves or sets whether the control creates IDropTargetHelper and IDragSourceHelper objects, so that a drag image can be displayed during OLE drag'n'drop. If set to True, the control creates the objects; otherwise not.

Remarks:

Requires shell32.dll version 5.0 or higher.

See also:

RegisterForOLEDragDrop, hImageList, ShowDragImage, OLEDragImageStyle, HeaderOLEDragImageStyle, IDropTargetHelper, IDragSourceHelper

OLE_COLOR TextBackColor [get, set]

Controls the appearance of item labels

Retrieves or sets the item labels' background color. If set to -1, the item labels are transparent.

See also:

ForeColor, BackColor, BkImage, HideLabels

LONG TileViewItemLines [get, set]

Controls the control's appearance in 'Tiles' and 'Extended Tiles' view

Retrieves or sets the number of lines with additional details that are displayed in 'Tiles' and 'Extended Tiles' view for each item.

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

View, TileViewTileHeight, TileViewTileWidth, IListViewItem::TileViewColumns

OLE_YSIZE_PIXELS TileViewLabelMarginBottom [get, set]

Controls the item labels' appearance in 'Tiles' and 'Extended Tiles' view

Retrieves or sets the bottom margin (in pixels) of the control's item labels in 'Tiles' and 'Extended Tiles' view.

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

TileViewLabelMarginLeft, TileViewLabelMarginRight, TileViewLabelMarginTop, TileViewTileHeight, TileViewTileWidth, View

OLE_XSIZE_PIXELS TileViewLabelMarginLeft [get, set]

Controls the item labels' appearance in 'Tiles' and 'Extended Tiles' view

Retrieves or sets the left margin (in pixels) of the control's item labels in 'Tiles' and 'Extended Tiles' view.

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

TileViewLabelMarginBottom, TileViewLabelMarginRight, TileViewLabelMarginTop, TileViewTileHeight, TileViewTileWidth, View

OLE_XSIZE_PIXELS TileViewLabelMarginRight [get, set]

Controls the item labels' appearance in 'Tiles' and 'Extended Tiles' view

Retrieves or sets the right margin (in pixels) of the control's item labels in 'Tiles' and 'Extended Tiles' view.

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

TileViewLabelMarginBottom, TileViewLabelMarginLeft, TileViewLabelMarginTop, TileViewTileHeight, TileViewTileWidth, View

OLE_YSIZE_PIXELS TileViewLabelMarginTop [get, set]

Controls the item labels' appearance in 'Tiles' and 'Extended Tiles' view

Retrieves or sets the top margin (in pixels) of the control's item labels in 'Tiles' and 'Extended Tiles' view.

Remarks:

Requires comctl32.dll version 6.0 or higher.

See also:

TileViewLabelMarginBottom, TileViewLabelMarginLeft, TileViewLabelMarginRight, TileViewTileHeight, TileViewTileWidth, View

OLE_COLOR TileViewSubItemForeColor [get, set]

Specifies the text color of sub-items in 'Tiles' and 'Extended Tiles' view

Retrieves or sets the text color of the sub-items in 'Tiles' and 'Extended Tiles' view. If set to -1, the system's default is used.

Remarks:

Requires comctl32.dll version 6.10 or higher.

See also:

ForeColor, View

OLE_YSIZE_PIXELS TileViewTileHeight [get, set]

Controls the tiles' size in 'Tiles' and 'Extended Tiles' view

Retrieves or sets the height (in pixels) of the control's tiles in 'Tiles' and 'Extended Tiles' view. If set to -1, the tiles' height is set to a value calculated automatically.

Remarks:

This property must be set to -1 for the 'Extended Tiles' view.
Requires comctl32.dll version 6.0 or higher.

See also:

TileViewTileWidth, TileViewLabelMarginBottom, TileViewLabelMarginLeft, TileViewLabelMarginRight, TileViewLabelMarginTop, View

OLE_XSIZE_PIXELS TileViewTileWidth [get, set]

Controls the tiles' size in 'Tiles' and 'Extended Tiles' view

Retrieves or sets the width (in pixels) of the control's tiles in 'Tiles' and 'Extended Tiles' view. If set to -1, the tiles' width is set to a value calculated automatically.

Remarks:

This property must be set to -1 for the 'Extended Tiles' view.
Requires comctl32.dll version 6.0 or higher.

See also:

TileViewTileHeight, TileViewLabelMarginBottom, TileViewLabelMarginLeft, TileViewLabelMarginRight, TileViewLabelMarginTop, View

ToolTipsConstants ToolTips [get, set]

Specifies which kinds of tooltips are displayed

Retrieves or sets which kinds of tooltips the control is displaying. Any combination of the values defined by the ToolTipsConstants enumeration is valid.

See also:

hWndToolTip, _IExplorerListViewEvents::ItemGetInfoTipText, ToolTipsConstants

UnderlinedItemsConstants UnderlinedItems [get, set]

Specifies which kinds of items are drawn underlined

Retrieves or sets which items are drawn underlined. Any combination of the values defined by the UnderlinedItemsConstants enumeration is valid.

See also:

ItemActivationMode, HotTracking, UnderlinedItemsConstants

VARIANT_BOOL UseMinColumnWidths [get, set]

Specifies whether the control applies the columns' minimum widths

Retrieves or sets whether the control applies the minimum column widths specified by the IListViewColumn::MinimumWidth property. If set to True, the user can't resize a column to a width smaller than the column's minimum width; otherwise the user can do so.

Remarks:

If this property is set to True, it won't be possible to resize any column to a width of 0. The minimum column width will be 30 pixels then. This is a limitation of the native list view control.
Requires comctl32.dll version 6.10 or higher.

See also:

IListViewColumn::MinimumWidth, IListViewColumn::Width, IListViewColumn::Resizable, ResizableColumns

VARIANT_BOOL UseSystemFont [get, set]

Specifies whether the control uses the system font

Retrieves or sets whether the control uses the system's default listview font or the font specified by the Font property. If set to True, the system font; otherwise the specified font is used.

See also:

Font

VARIANT_BOOL UseWorkAreas [get, set]

Specifies whether the control's items are arranged in working areas

Retrieves or sets how the control arranges its items, if the AutoArrangeItems property is not set to aaiNone. If UseWorkAreas is set to True, the items won't be auto-arranged before at least one working area is defined; otherwise they will be auto-arranged immediately.

See also:

AutoArrangeItems, WorkAreas

BSTR Version [get]

Retrieves the control's version

Remarks:

This property is read-only.

ViewConstants View [get, set]

Specifies the control's view mode

Retrieves or sets the control's view mode. Any of the values defined by the ViewConstants enumeration is valid.

Remarks:

Changing the view mode to 'Extended Tiles' resets any sub-items.

See also:

FullRowSelect, GridLines, Columns, Groups, WorkAreas, ViewConstants

LONG VirtualItemCount [get, set]

Specifies the number of items in virtual mode

Retrieves or sets the number of items in the control if the VirtualMode property is set to True.

Parameters:

[in]	noScroll	If set to True, the control won't change the scrolling position when changing this property. Otherwise it will reset the scrolling position. This parameter is ignored when retrieving this property.
[in]	noInvalidateAll	If set to True, the control will repaint only if changing this property affects the items currently in view. Otherwise it will definitely repaint. This parameter is ignored when retrieving this property.

See also:

VirtualMode

VARIANT_BOOL VirtualMode [get, set]

Specifies whether data-management is done by the application instead of the control

Retrieves or sets whether the data-management for the control is done by your application or by the control itself. If set to True, data-management is done by your application; otherwise it's done by the control.

Remarks:

Using your own data-management system may increase performance, especially if the listview contains many items. However, virtual listview controls have several limitations (list may be incomplete):

• With comctl32.dll version 6.0 'Tiles' view is not fully supported.
• With comctl32.dll version 6.0 groups are not supported.
• Working areas are not supported.
• Item sorting is not supported.
• Clicks on state images won't be recognized in 'Icons', 'Small Icons' and 'Tiles' view.
• IListViewItem::IconIndex is read-only and must be set using the _IExplorerListViewEvents::ItemGetDisplayInfo event.
• IListViewSubItem::IconIndex is read-only and must be set using the _IExplorerListViewEvents::ItemGetDisplayInfo event.
• IListViewItem::ID is not supported.
• IListViewItem::Indent is read-only and must be set using the _IExplorerListViewEvents::ItemGetDisplayInfo event.
• IListViewItem::ItemData is not supported.
• IListViewItem::OverlayIndex is supported as a callback property only. Look up the CallBackMask property for details.
• IListViewSubItem::OverlayIndex is supported as a callback property only. Look up the CallBackMask property for details.
• IListViewItem::StateImageIndex is supported as a callback property only. Look up the CallBackMask property for details.
• IListViewSubItem::StateImageIndex is supported as a callback property only. Look up the CallBackMask property for details.
• IListViewItem::Text is read-only and must be set using the _IExplorerListViewEvents::ItemGetDisplayInfo event.
• IListViewSubItem::Text is read-only and must be set using the _IExplorerListViewEvents::ItemGetDisplayInfo event.
• IListViewItem::TileViewColumns is read-only and must be set using the _IExplorerListViewEvents::ItemGetDisplayInfo event.

Attention:

Changing this property destroys and recreates the control window.

See also:

VirtualItemCount, ShowGroups, CallBackMask, _IExplorerListViewEvents::CacheItemsHint, _IExplorerListViewEvents::ItemGetDisplayInfo, _IExplorerListViewEvents::SelectedItemRange, _IExplorerListViewEvents::FindVirtualItem

IListViewWorkAreas WorkAreas [get]

Retrieves the control's working areas

Retrieves a collection object wrapping the control's working areas.

Remarks:

The 'List' and 'Details' views don't support working areas.
Working areas can't be used together with groups.
This property is read-only.

See also:

View, ShowGroups, AutoArrangeItems, UseWorkAreas, IListViewWorkAreas, IListViewItem::WorkArea