LB_FINDSTRINGEXACT

This message is sent by an application to find the first list box string that matches the string specified in the lpszFind parameter.

At a Glance

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

Syntax

LB_FINDSTRINGEXACT wParam = (WPARAM) indexStart;
lParam = (LPARAM)(LPCSTR) lpszFind;

Parameters

indexStart

Zero-based index of the item before the first item to be searched. When the search reaches the bottom of the list box, it continues from the top of the list box back to the item specified by the indexStart parameter. If indexStart is –1, the entire list box is searched from the beginning.

lpszFind

Long pointer to the null-terminated string to search for. This string can contain a complete filename, including the extension. The search is not case sensitive, so this string can contain any combination of uppercase and lowercase letters.

Return Values

The zero-based index of the matching item indicates success. LB_ERR indicates an unsuccessful search.

Remarks

If an application creates the list box with an owner-drawn style but without the LBS_HASSTRINGS style, the action taken by LB_FINDSTRINGEXACT depends on whether the LBS_SORT style is used. If LBS_SORT is used, the system sends WM_COMPAREITEM messages to the list box owner to determine which item matches the specified string. Otherwise, LB_FINDSTRINGEXACT attempts to match the 32-bit value against the value of the lpszFind parameter.

See Also

LB_FINDSTRING, LB_SELECTSTRING, WM_COMPAREITEM