IListView

The original IListView methods are (as ordered in the virtual function table after the IOleWindow methods):

with prototypes:

HRESULT GetImageList (INT, HIMAGELIST *);

HRESULT SetImageList (INT, HIMAGELIST, HIMAGELIST *);

HRESULT GetBackgroundColor (COLORREF *);

HRESULT SetBackgroundColor (COLORREF);

HRESULT GetTextColor (COLORREF *);

HRESULT SetTextColor (COLORREF);

HRESULT GetTextBackgroundColor (COLORREF *);

HRESULT SetTextBackgroundColor (COLORREF);

HRESULT GetHotLightColor (COLORREF *);

HRESULT SetHotLightColor (COLORREF);

HRESULT GetItemCount (int *);

HRESULT SetItemCount (int, DWORD);

HRESULT GetItem (LVITEMW *);

HRESULT SetItem (LVITEMW * const);

HRESULT GetItemState (int, int, ULONG, ULONG *);

HRESULT SetItemState (int, int, ULONG, ULONG);

HRESULT GetItemText (INT, INT, PWSTR, INT);

HRESULT SetItemText (int, int, PCWSTR);

HRESULT GetBackgroundImage (LVBKIMAGEW *);

HRESULT SetBackgroundImage (LVBKIMAGEW * const);

HRESULT GetFocusedColumn (INT *);

HRESULT SetSelectionFlags (ULONG, ULONG);

HRESULT GetSelectedColumn (INT *);

HRESULT SetSelectedColumn (int);

HRESULT GetView (DWORD *);

HRESULT SetView (DWORD);

HRESULT InsertItem (LVITEMW * const, int *);

HRESULT DeleteItem (int);

HRESULT DeleteAllItems (VOID);

HRESULT UpdateItem (int);

HRESULT GetItemRect (LVITEMINDEX, int, RECT *);

HRESULT GetSubItemRect (LVITEMINDEX, INT, INT, RECT *);

HRESULT HitTestSubItem (LVHITTESTINFO *);

HRESULT GetIncrSearchString (PWSTR, INT, INT *);

HRESULT GetItemSpacing (BOOL, INT *, INT *);

HRESULT SetIconSpacing (INT, INT, INT *, INT *);

HRESULT GetNextItem (LVITEMINDEX, ULONG, LVITEMINDEX *);

HRESULT FindItem (LVITEMINDEX, LVFINDINFOW const *, LVITEMINDEX *);

HRESULT GetSelectionMark (LVITEMINDEX *);

HRESULT SetSelectionMark (LVITEMINDEX, LVITEMINDEX *);

HRESULT GetItemPosition (LVITEMINDEX, POINT *);

HRESULT SetItemPosition (int, POINT const *);

HRESULT ScrollView (int, int);

HRESULT EnsureItemVisible (LVITEMINDEX, BOOL);

HRESULT EnsureSubItemVisible (LVITEMINDEX, INT);

HRESULT EditSubItem (LVITEMINDEX, INT);

HRESULT RedrawItems (int, int);

HRESULT ArrangeItems (int);

HRESULT RecomputeItems (INT);

HRESULT GetEditControl (HWND *);

HRESULT EditLabel (LVITEMINDEX, PCWSTR, HWND *);

HRESULT EditGroupLabel (INT);

HRESULT CancelEditLabel (VOID);

HRESULT GetEditItem (LVITEMINDEX *, INT *);

HRESULT HitTest (LVHITTESTINFO *);

HRESULT GetStringWidth (PCWSTR, int *);

HRESULT GetColumn (int, LVCOLUMNW *);

HRESULT SetColumn (int, LVCOLUMNW * const);

HRESULT GetColumnOrderArray (int, int *);

HRESULT SetColumnOrderArray (int, int const *);

HRESULT GetHeaderControl (HWND *);

HRESULT InsertColumn (int, LVCOLUMNW * const, int *);

HRESULT DeleteColumn (int);

HRESULT CreateDragImage (int, POINT const *, HIMAGELIST *);

HRESULT GetViewRect (RECT *);

HRESULT GetClientRect (BOOL, RECT *);

HRESULT GetColumnWidth (INT, INT *);

HRESULT SetColumnWidth (int, int);

HRESULT GetCallbackMask (ULONG *);

HRESULT SetCallbackMask (ULONG);

HRESULT GetTopIndex (int *);

HRESULT GetCountPerPage (int *);

HRESULT GetOrigin (POINT *);

HRESULT GetSelectedCount (INT *);

HRESULT SortItems (BOOL, LPARAM, PFNLVCOMPARE);

HRESULT GetExtendedStyle (DWORD *);

HRESULT SetExtendedStyle (DWORD, DWORD, DWORD *);

HRESULT GetHoverTime (UINT *);

HRESULT SetHoverTime (UINT, UINT *);

HRESULT GetToolTip (HWND *);

HRESULT SetToolTip (HWND, HWND *);

HRESULT GetHotItem (LVITEMINDEX *);

HRESULT SetHotItem (LVITEMINDEX, LVITEMINDEX *);

HRESULT GetHotCursor (HCURSOR *);

HRESULT SetHotCursor (HCURSOR, HCURSOR *);

HRESULT ApproximateViewRect (int, INT *, INT *);

HRESULT SetRangeObject (INT, ILVRange *);

HRESULT GetWorkAreas (int, RECT *);

HRESULT SetWorkAreas (int, RECT const *);

HRESULT GetWorkAreaCount (INT *);

HRESULT ResetEmptyText (VOID);

HRESULT EnableGroupView (INT);

HRESULT IsGroupViewEnabled (BOOL *);

HRESULT SortGroups (PFNLVGROUPCOMPARE, PVOID);

HRESULT GetGroupInfo (INT, INT, LVGROUP *);

HRESULT SetGroupInfo (INT, INT, LVGROUP * const);

HRESULT GetGroupRect (BOOL, int, INT, RECT *);

HRESULT GetGroupState (INT, ULONG, ULONG *);

HRESULT HasGroup (int, BOOL *);

HRESULT InsertGroup (int, LVGROUP * const, int *);

HRESULT RemoveGroup (INT);

HRESULT InsertGroupSorted (LVINSERTGROUPSORTED const *, int *);

HRESULT GetGroupMetrics (LVGROUPMETRICS *);

HRESULT SetGroupMetrics (LVGROUPMETRICS * const);

HRESULT RemoveAllGroups (VOID);

HRESULT GetFocusedGroup (INT *);

HRESULT GetGroupCount (INT *);

HRESULT SetOwnerDataCallback (IOwnerDataCallback *);

HRESULT GetTileViewInfo (LVTILEVIEWINFO *);

HRESULT SetTileViewInfo (LVTILEVIEWINFO * const);

HRESULT GetTileInfo (LVTILEINFO *);

HRESULT SetTileInfo (LVTILEINFO * const);

HRESULT GetInsertMark (LVINSERTMARK *);

HRESULT SetInsertMark (LVINSERTMARK const *);

HRESULT GetInsertMarkRect (RECT *);

HRESULT GetInsertMarkColor (COLORREF *);

HRESULT SetInsertMarkColor (COLORREF, COLORREF *);

HRESULT HitTestInsertMark (POINT const *, LVINSERTMARK *);

HRESULT SetInfoTip (LVSETINFOTIP * const);

HRESULT GetOutlineColor (COLORREF *);

HRESULT SetOutlineColor (COLORREF, COLORREF *);

HRESULT GetFrozenItem (INT *);

HRESULT SetFrozenItem (INT, INT);

HRESULT GetFrozenSlot (RECT *);

HRESULT SetFrozenSlot (INT, POINT const *);

HRESULT GetViewMargin (RECT *);

HRESULT SetViewMargin (RECT const *);

HRESULT SetKeyboardSelected (LVITEMINDEX);

HRESULT MapIndexToId (INT, INT *);

HRESULT MapIdToIndex (INT, INT *);

HRESULT IsItemVisible (LVITEMINDEX, BOOL *);

HRESULT GetGroupSubsetCount (INT *);

HRESULT SetGroupSubsetCount (INT);

HRESULT GetVisibleSlotCount (INT *);

HRESULT GetColumnMargin (RECT *);

HRESULT SetSubItemCallback (ISubItemCallback *);

HRESULT GetVisibleItemRange (LVITEMINDEX *, LVITEMINDEX *);

HRESULT SetTypeAheadFlags (UINT, UINT);

in which ILVRange, IOwnerDataCallback and ISubItemCallback are apparently undocumented interfaces.

The revision for Windows 7 inserts a method (near to the end of the virtual function table):

The new method has the prototype:

HRESULT EnableAlphaShadow (BOOL);

Two other methods have slight changes to their prototypes:

HRESULT SetSelectionFlags (SELECTION_FLAGS, SELECTION_FLAGS);

HRESULT SetTypeAheadFlags (TYPEAHEAD_FLAGS, TYPEAHEAD_FLAGS);

in which SELECTION_FLAGS and TYPEAHEAD_FLAGS are formal enumerations to replace what had been mere integers.

Implementation

The one known implementation of the IListView interface is by COMCTL32 for a class that Microsoft’s symbol files name as CListView. An instance of this class is created for each List-View control. To get a pointer to a List-View control’s IListView interface, send message 0x10BD to the control, with wParam addressing IID_IListView and with lParam addressing a variable that will receive the interface pointer.

Availability

The IListView interface is implemented in COMCTL32 versions 6.10 and higher.

Though new for Windows Vista, this interface is not documented by Microsoft in the January 2007 edition of the Software Development Kit (SDK) for Windows Vista.

Neither does the SDK document the window message (perhaps named something like LVM_QUERYINTERFACE) through which a List-View control exposes its interfaces. This is all rather curious. Where the methods correspond closely with the messages, the natural expectation is that calling the methods will be vastly more efficient than sending messages. Add that some of the methods do things for which there is no corresponding message, and that some messages are anyway undocumented, and it is hard to escape the notion that Microsoft has given List-View controls some significant new machinery for the benefit of some favoured users. Will these games ever stop?