CTreeCtrl::HitTest

아티클
06/10/2015

Tree view 컨트롤의 클라이언트 영역을 기준으로 지정 된 지점의 위치를 확인 하려면이 함수를 호출 합니다.

HTREEITEM HitTest( 
   CPoint pt, 
   UINT* pFlags = NULL 
) const; 
HTREEITEM HitTest( 
   TVHITTESTINFO* pHitTestInfo  
) const;

매개 변수

pt
테스트 클라이언트 좌표입니다.
pFlags
적중된 테스트의 결과 대 한 정보를 수신 하는 정수에 대 한 포인터입니다. 하나가 될 수 있습니다 또는 아래 나열 된 값은 플래그 비고 섹션의 멤버.
pHitTestInfo
주소는 TVHITTESTINFO 적중 테스트 하 고 위치를 포함 하는 구조 적중된 테스트의 결과 대 한 정보를 받습니다.

반환 값

지정 된 위치를 차지 하는 트리 뷰 항목의 핸들 또는 NULL 점 항목이 차지 하는 경우.

설명

이 함수를 호출할 때의 pt 매개 변수는 테스트할 점의 좌표를 지정 합니다. 함수는 지정 된 위치에 있는 항목의 핸들을 반환 하거나 NULL 점 항목이 차지 하는 경우. 또한는 pFlags 매개 변수는 지정 된 점의 위치를 나타내는 값을 포함 합니다. 가능한 값은 다음과 같습니다.

값	의미
TVHT_ABOVE	클라이언트 영역 위에 있습니다.
TVHT_BELOW	아래 클라이언트 영역입니다.
TVHT_NOWHERE	클라이언트 영역에 있지만 마지막 항목 아래에 있습니다.
TVHT_ONITEM	비트맵 또는 레이블 항목에 연결 합니다.
TVHT_ONITEMBUTTON	항목에 연결 된 단추.
TVHT_ONITEMICON	비트맵에서 항목에 연결 합니다.
TVHT_ONITEMINDENT	들여쓰기의 항목에 연결 합니다.
TVHT_ONITEMLABEL	항목과 연관 된 레이블에 (문자열).
TVHT_ONITEMRIGHT	항목의 오른쪽에 있는 영역입니다.
TVHT_ONITEMSTATEICON	트리 보기 항목의 상태 아이콘에 사용자 정의 상태입니다.
TVHT_TOLEFT	클라이언트 영역의 왼쪽에 있습니다.
TVHT_TORIGHT	클라이언트 영역 오른쪽에 있습니다.

예제

// Select the item that is at the point myPoint.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);

if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
   m_TreeCtrl.SelectItem(hItem);
}