LB_GETTEXT

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This message is sent by an application to retrieve a string from a list box.

Syntax

LB_GETTEXT wParam = (WPARAM) index;
    lParam = (LPARAM)(LPCTSTR) lpszBuffer;

Parameters

• index
  Zero-based index of the string to retrieve.

• lpszBuffer
  long pointer to the buffer to receive the string. The buffer must have sufficient space for the string and a terminating null character. An LB_GETTEXTLEN message can be sent before the LB_GETTEXT message to retrieve the length, in characters, of the string.

Return Value

The length of the string, in characters and excluding the terminating null character, indicates success. LB_ERR indicates that index does not specify a valid index.

Remarks

If you create the list box with an owner-drawn style but without the LBS_HASSTRINGS style, the buffer pointed to by the lpszBuffer parameter will receive the 32-bit value associated with the item (the item data).

Requirements

See Also

Reference

LB_GETTEXTLEN
List Boxes Messages