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 [데스크톱 앱만 해당] |
| 헤더 |
|