LVFINDINFOA 구조체(commctrl.h)

목록 뷰 항목을 검색할 때 사용되는 정보를 포함합니다. 이 구조체는 LV_FINDINFO와 동일하지만 표준 명명 규칙에 맞게 이름이 변경되었습니다.

구문

typedef struct tagLVFINDINFOA {
  UINT   flags;
  LPCSTR psz;
  LPARAM lParam;
  POINT  pt;
  UINT   vkDirection;
} LVFINDINFOA, *LPFINDINFOA;

멤버

flags

형식: UINT

수행할 검색 유형입니다. 이 멤버는 다음 값 중 하나 이상으로 설정할 수 있습니다.

값	의미
LVFI_PARAM	이 구조체의 lParam 멤버와 항목의 LVITEM 구조체의 lParam 멤버 간의 일치 항목을 검색합니다.
LVFI_PARTIAL	항목 텍스트가 psz 멤버가 가리키는 문자열로 시작하는지 확인합니다. 이 값은 LVFI_STRING 사용을 의미합니다.
LVFI_STRING	항목 텍스트를 기준으로 검색합니다. 추가 값을 지정하지 않는 한 일치하는 항목의 항목 텍스트는 psz 멤버가 가리키는 문자열과 정확히 일치해야 합니다. 그러나 검색은 대/소문자를 구분하지 않습니다.
LVFI_SUBSTRING	Windows Vista 이상. LVFI_PARTIAL 동일합니다.
LVFI_WRAP	일치하는 항목이 없으면 처음부터 검색을 계속합니다. 이 플래그를 단독으로 사용하는 경우 문자열 검색을 원한다고 가정합니다.
LVFI_NEARESTXY	vkDirection 멤버가 지정한 방향으로 pt 멤버에 지정된 위치에 가장 가까운 항목을 찾습니다. 이 플래그는 큰 아이콘 및 작은 아이콘 모드에서만 지원됩니다. LVFI_NEARESTXY 지정하면 다른 모든 플래그는 무시됩니다.

psz

형식: LPCTSTR

항목 텍스트와 비교할 null로 끝나는 문자열의 주소입니다. 플래그 멤버에서 LVFI_STRING 또는 LVFI_PARTIAL 설정된 경우에만 유효합니다.

lParam

형식: LPARAM

목록 보기 항목의 LVITEM 구조체의 lParam 멤버와 비교할 값입니다. LVFI_PARAM 플래그 멤버에 설정된 경우에만 유효합니다.

pt

형식: POINT

초기 검색 위치가 있는 POINT 구조체입니다. 플래그 멤버에서 LVFI_NEARESTXY 설정된 경우에만 유효합니다.

vkDirection

형식: UINT

검색 방향을 지정하는 가상 키 코드입니다. 지원되는 코드는 다음과 같습니다.

• VK_LEFT
• VK_RIGHT
• VK_UP
• VK_DOWN
• VK_HOME
• VK_END
• VK_PRIOR
• VK_NEXT

이 멤버는 LVFI_NEARESTXY 플래그 멤버에 설정된 경우에만 유효합니다.

설명

참고

commctrl.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 LVFINDINFO를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	commctrl.h