LVM_GETISEEARCHSTRING 메시지

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

매개 변수

wParam

0이어야 합니다.

lParam

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

반환 값

종료 NULL 문자를 포함하지 않고 증분 검색 문자열의 문자 수를 반환하거나 목록 뷰 컨트롤이 증분 검색 모드에 있지 않은 경우 0을 반환합니다.

설명

보안 경고: 이 메시지를 잘못 사용하면 프로그램의 보안이 손상될 수 있습니다. 이 메시지는 버퍼 크기를 알 수 있는 방법을 제공하지 않습니다. 이 메시지를 사용하는 경우 먼저 lParam에서 NULL을 전달하는 메시지를 호출하면 필요한 NULL을 제외한 문자 수를 반환합니다. 그런 다음 메시지를 다시 호출하여 문자열을 검색합니다. 계속하기 전에 보안 고려 사항: Microsoft Windows 컨트롤을 검토해야 합니다.

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

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

버퍼가 문자열과 종료 NULL 문자를 보유할 수 있을 만큼 충분히 큰지 확인합니다. 너무 작으면 즉시 잘못된 페이지 폴트가 발생합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	Commctrl.h
유니코드 및 ANSI 이름	LVM_GETISEARCHSTRINGW(유니코드) 및 LVM_GETISEARCHSTRINGA(ANSI)