LB_SETITEMDATA

This message is sent by an application to set a 32-bit value associated with the specified item in a list box.

At a Glance

Header file: Winuser.h
Windows CE versions: 1.0 and later

Syntax

LB_SETITEMDATA wParam = (WPARAM) index;
lParam = (LPARAM) dwData;

Parameters

index

Zero-based index of the item.

Windows 95 and Windows 98: The wParam parameter is limited to 16-bit values. This means list boxes cannot contain more than 32,767 items. Although the number of items is restricted, the total size in bytes of the items in a list box is limited only by available memory.

dwData

Specifies the 32-bit value to be associated with the item.

Return Values

LB_ERR indicates that an error has occurred.

Remarks

If the item is in an owner-drawn list box created without the LBS_HASSTRINGS style, this message replaces the 32-bit value contained in the lParam parameter of the LB_ADDSTRING or LB_INSERTSTRING message that added the item to the list box.

See Also

LB_ADDSTRING, LB_GETITEMDATA, LB_INSERTSTRING