Share via

LVHITTESTINFO 구조체(commctrl.h)

  • 아티클

적중 횟수 테스트에 대한 정보를 포함합니다. 이 구조체는 하위 항목 적중 횟수 테스트를 수용하도록 확장되었습니다. LVM_HITTEST 및 LVM_SUBITEMHITTEST 메시지 그리고 관련 매크로와 연결하여 사용됩니다. 이 구조체는 LVHITTESTINFO 구조체를 대체합니다.

구문

typedef struct tagLVHITTESTINFO {
  POINT pt;
  UINT  flags;
  int   iItem;
  int   iSubItem;
  int   iGroup;
} LVHITTESTINFO, *LPLVHITTESTINFO;

멤버

pt

형식: POINT

클라이언트 좌표에서 테스트에 적중할 위치입니다.

flags

형식: UINT

적중 테스트 결과에 대한 정보를 수신하는 변수입니다. 이 멤버는 다음 값 중 하나 이상일 수 있습니다.

LVHT_ABOVE, LVHT_BELOW, LVHT_TOLEFT 및 LVHT_TORIGHT 사용하여 목록 보기 컨트롤의 내용을 스크롤할지 여부를 결정할 수 있습니다. 이러한 값 중 두 가지를 결합할 수 있습니다. 예를 들어 위치가 클라이언트 영역의 위와 왼쪽에 있는 경우 LVHT_ABOVE 및 LVHT_TOLEFT 모두 사용할 수 있습니다. 

LVHT_ONITEM 테스트하여 지정된 위치가 목록 보기 항목 위에 있는지 여부를 확인할 수 있습니다. 이 값은 LVHT_ONITEMICON, LVHT_ONITEMLABEL 및 LVHT_ONITEMSTATEICON 대한 비트 OR 작업입니다.

값 의미
LVHT_ABOVE
 위치가 컨트롤의 클라이언트 영역 위에 있습니다.
LVHT_BELOW
 위치가 컨트롤의 클라이언트 영역 아래에 있습니다.
LVHT_NOWHERE
 위치는 목록 보기 컨트롤의 클라이언트 창 내에 있지만 목록 항목을 통해서가 아닙니다.
LVHT_ONITEMICON
 위치는 목록 보기 항목의 아이콘 위에 있습니다.
LVHT_ONITEMLABEL
 위치는 목록 보기 항목의 텍스트 위에 있습니다.
LVHT_ONITEMSTATEICON
 위치는 목록 보기 항목의 상태 이미지 위에 있습니다.
LVHT_TOLEFT
 위치는 목록 보기 컨트롤의 클라이언트 영역 왼쪽에 있습니다.
LVHT_TORIGHT
 위치는 목록 보기 컨트롤의 클라이언트 영역 오른쪽에 있습니다.
LVHT_EX_GROUP_HEADER
 Windows Vista 지점은 그룹 헤더 내에 있습니다.
LVHT_EX_GROUP_FOOTER
 Windows Vista 지점은 그룹 바닥글 내에 있습니다.
LVHT_EX_GROUP_COLLAPSE
 Windows Vista 지점은 그룹의 축소/확장 단추 내에 있습니다.
LVHT_EX_GROUP_BACKGROUND
 Windows Vista 지점은 항목이 표시되는 그룹의 영역 내에 있습니다.
LVHT_EX_GROUP_STATEICON
 Windows Vista 지점은 그룹의 상태 아이콘 내에 있습니다.
LVHT_EX_GROUP_SUBSETLINK
 Windows Vista 지점은 그룹의 하위 집합 링크 내에 있습니다.
LVHT_EX_GROUP
 Windows Vista LVHT_EX_GROUP_BACKGROUND | LVHT_EX_GROUP_COLLAPSE | LVHT_EX_GROUP_FOOTER | LVHT_EX_GROUP_HEADER | LVHT_EX_GROUP_STATEICON | LVHT_EX_GROUP_SUBSETLINK.
LVHT_EX_ONCONTENTS
 Windows Vista 지점은 배경이 아닌 항목의 아이콘 또는 텍스트 콘텐츠 내에 있습니다.
LVHT_EX_FOOTER
 Windows Vista 점이 목록 보기 컨트롤의 바닥글 내에 있습니다.

iItem

형식: int

일치하는 항목의 인덱스를 받습니다. 또는 하위 항목을 적중 테스트하는 경우 이 값은 하위 항목의 부모 항목을 나타냅니다.

iSubItem

형식: int

버전 4.70. 일치하는 하위 항목의 인덱스를 받습니다. 항목을 적중 테스트할 때 이 멤버는 0이 됩니다.

iGroup

형식: int

Windows Vista. 항목 적중(읽기 전용)의 그룹 인덱스입니다. 소유자 데이터에만 유효합니다. 점이 여러 그룹에 표시되는 항목 내에 있는 경우 iGroup 은 항목의 그룹 인덱스 를 지정합니다.

요구 사항

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