ListView_GetISearchString 매크로(commctrl.h)
목록 보기 컨트롤의 증분 검색 문자열을 가져옵니다. 이 매크로를 사용하거나 LVM_GETISEARCHSTRING 메시지를 명시적으로 보낼 수 있습니다.
통사론
BOOL ListView_GetISearchString(
HWND hwndLV,
LPSTR lpsz
);
매개 변수
hwndLV
형식: HWND
목록 보기 컨트롤에 대한 핸들입니다.
lpsz
형식: LPSTR
증분 검색 문자열을 수신하는 버퍼에 대한 포인터입니다. 문자열의 길이를 검색하려면
반환 값
형식: BOOL
증분 검색 문자열의 문자 수를 반환하거나 목록 보기 컨트롤이 증분 검색 모드가 아닌 경우 0을 반환합니다.
발언
증분 검색 문자열은 목록 보기에 입력 포커스가 있는 동안 사용자가 입력하는 문자 시퀀스입니다. 사용자가 문자를 입력할 때마다 시스템은 검색 문자열에 문자를 추가한 다음 일치하는 항목을 검색합니다. 시스템에서 일치 항목을 찾으면 항목을 선택하고 필요한 경우 보기로 스크롤합니다.
제한 시간은 사용자가 형식을 지정하는 각 문자와 연결됩니다. 사용자가 다른 문자를 입력하기 전에 제한 시간이 경과하면 증분 검색 문자열이 다시 설정됩니다.
버퍼가 문자열을 저장할 만큼 충분히 큰지 확인합니다. 너무 작으면 즉시 잘못된 페이지 오류가 발생합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | commctrl.h |