ListView_GetISearchString 매크로(commctrl.h)

목록 뷰 컨트롤의 증분 검색 문자열을 가져옵니다. 이 매크로를 사용하거나 LVM_GETISEARCHSTRING 메시지를 명시적으로 보낼 수 있습니다.

구문

void ListView_GetISearchString(
   hwndLV,
   lpsz
);

매개 변수

hwndLV

형식: HWND

목록 보기 컨트롤에 대한 핸들입니다.

lpsz

형식: LPSTR

증분 검색 문자열을 수신하는 버퍼에 대한 포인터입니다. 문자열의 길이만 검색하려면 lpsz 를 NULL로 설정합니다.

반환 값

없음

설명

증분 검색 문자열은 목록 뷰에 입력 포커스가 있는 동안 사용자가 입력하는 문자 시퀀스입니다. 사용자가 문자를 입력할 때마다 시스템이 해당 문자를 검색 문자열에 추가한 다음 일치하는 항목을 검색합니다. 시스템이 일치하는 항목을 찾으면 항목을 선택하고 필요한 경우 보기로 스크롤합니다.

시간 초과 기간은 사용자가 입력하는 각 문자와 연결됩니다. 사용자가 다른 문자를 입력하기 전에 제한 시간이 경과하면 증분 검색 문자열이 초기화됩니다.

버퍼가 문자열을 저장할 만큼 충분히 큰지 확인합니다. 너무 작으면 즉시 잘못된 페이지 폴트가 발생합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	commctrl.h