LB_SELECTSTRING 메시지

지정된 문자열의 문자로 시작하는 항목에 대한 목록 상자를 검색합니다. 일치하는 항목을 찾으면 해당 항목이 선택됩니다.

매개 변수

wParam

검색될 첫째 항목 앞에 나오는 항목의 0부터 시작하는 인덱스입니다. 목록 상자의 맨 아래까지 검색을 마치면 목록 상자 맨 위부터 wParam 매개 변수로 지정된 항목까지 다시 검색을 계속합니다. wParam이 -1이면 전체 목록 상자를 처음부터 검색합니다.

Windows 95/Windows 98/Windows Millennium Edition(Windows Me): wParam 매개 변수는 16비트 값으로 제한됩니다. 즉, 목록 상자는 32,767개 이상의 항목을 포함할 수 없습니다. 항목 수는 제한되어 있지만 목록 상자에 있는 항목의 총 바이트 크기는 사용 가능한 메모리에 의해서만 제한됩니다.

lParam

검색할 접두사가 포함된 null로 끝나는 문자열에 대한 포인터입니다. 검색은 대/소문자를 구분하지 않으므로 이 문자열에는 대문자와 소문자가 섞여 있을 수 있습니다.

반환 값

검색에 성공하면 반환 값은 선택한 항목의 인덱스입니다. 검색에 실패하면 반환 값은 LB_ERR이며 현재 선택이 변경되지 않습니다.

설명

필요한 경우 목록 상자를 스크롤하여 선택한 항목을 볼 수 있습니다.

LBS_MULTIPLESEL 또는 LBS_EXTENDEDSEL 스타일이 있는 목록 상자에서는 이 메시지를 사용하지 마세요.

시작점의 초기 문자가 lParam 매개 변수로 지정된 문자열의 문자와 일치하는 경우에만 항목이 선택됩니다.

목록 상자에 Owner-Drawn 스타일이 있지만 LBS_HASSTRINGS 스타일은 없는 경우, LB_SELECTSTRING에서 수행하는 작업은 LBS_SORT 스타일을 사용하는지 여부에 따라 달라집니다. LBS_SORT 스타일을 사용하는 경우 시스템은 목록 상자 소유자에게 WM_COMPAREITEM 메시지를 지정된 문자열과 일치하는 항목을 확인합니다. 그렇지 않으면 LB_SELECTSTRING은 lParam 매개 변수와 일치하는 긴 값(LB_ADDSTRING 또는 LB_INSERTSTRING 메시지의 lParam 매개 변수로 제공됨)이 있는 항목을 찾으려고 시도합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	Winuser.h(Windows.h 포함)

추가 정보

참조

LB_ADDSTRING

LB_FINDSTRING

LB_INSERTSTRING