XLL+ Class Library (6.3)

CXlControlListBox::SetItemDataPtr

Sets a pointer to the list-box item

int SetItemDataPtr(
   int nIndex,
   void* dwItemData
);

Parameters

nIndex

Specifies the zero-based index of the item in the list box.

dwItemData

Specifies the pointer to be associated with the item.

Return Value

-1 if an error occurs.

Remarks

Sets the 32-bit value associated with the specified item in a list box to be the specified pointer (void*). This pointer remains valid for the life of the list box, even though the item's relative position within the list box might change as items are added or removed. Hence, the item's index within the box can change, but the pointer remains reliable.

Requirements

Header: xldialog.h

See Also

CXlControlListBox Class | CXlControlListBox Methods