트리 컨트롤 항목 상태 개요

트리 컨트롤의 각 항목 (CTreeCtrl) 현재 상태에 있습니다.예를 들어, 항목 사용 안 함, 확장 등 선택할 수 있습니다.대부분의 tree 컨트롤 항목의 선택과 같은 사용자 작업을 반영 하도록 항목의 상태를 자동으로 설정 합니다.그러나 항목의 상태를 사용 하 여 설정할 수도 있습니다의 SetItemState 멤버 함수를 사용 하 여 항목의 현재 상태를 검색 하 고 있는 GetItemState 멤버 함수.항목 상태에 대 한 전체 목록을 참조 하십시오. 트리 뷰 컨트롤 상수 에 있는 Windows SDK.

지정 된 항목의 현재 상태는 nState 매개 변수.Tree 컨트롤은 선택 항목 또는 항목에 포커스를 설정 하는 것과 같은 사용자 작업을 반영 하도록 항목의 상태를 변경할 수 있습니다.또한 응용 프로그램이 비활성화 하거나 숨길 항목 또는 오버레이 이미지 또는 이미지 상태를 지정 하는 항목의 상태를 변경할 수 있습니다.

지정 하거나 항목의 상태를 변경 하는 경우는 nStateMask 매개 변수를 지정 하는 상태를 설정 하려면 비트 및 nState 매개 변수에 새 값이 비트를 포함 합니다.예를 들어, 다음은 부모 항목의 현재 상태 변경 (지정 된 hParentItem)에 CTreeCtrl 개체 (m_treeCtrl)를 TVIS_EXPANDPARTIAL:

TVITEM curItem;
HTREEITEM hParentItem;

hParentItem = m_TreeCtrl.GetSelectedItem();

//modify the parent item to keep the '+' sign
curItem.mask = TVIF_STATE | TVIF_HANDLE;
curItem.hItem = hParentItem;
curItem.state = TVIS_EXPANDPARTIAL;
curItem.stateMask = TVIS_EXPANDPARTIAL;
m_TreeCtrl.SetItem(&curItem);

항목의 오버레이 이미지를 설정 하려면 상태 변경의 또 다른 예가입니다.이 수행 하 nStateMask 포함 해야는 TVIS_OVERLAYMASK 값 및 nState 8 비트를 사용 하 여 왼쪽 하나 기반 인덱스 이동 오버레이 이미지를 포함 해야의 INDEXTOOVERLAYMASK 매크로.인덱스 0 없음 오버레이 이미지를 지정 될 수 있습니다.오버레이 이미지 오버레이 이미지는 트리 컨트롤의 목록에 대 한 이전 호출에 의해 추가 해 두어야는 CImageList::SetOverlayImage 함수.함수에 추가할 이미지의 1부터 시작 인덱스를 지정 합니다. 이 인덱스를 사용 하는 INDEXTOOVERLAYMASK 매크로.Tree 컨트롤은 오버레이 이미지를 4 개까지 가질 수 있습니다.

항목의 상태 이미지를 설정 하려면 nStateMask 포함 해야는 TVIS_STATEIMAGEMASK 값을 및 nState 1부터 인덱스 시프트 상태 이미지를 사용 하 여 12 비트 왼쪽에 있어야는 INDEXTOSTATEIMAGEMASK 매크로.인덱스 0 없음 상태 이미지를 지정 될 수 있습니다.이미지 오버레이 및 상태에 대 한 자세한 내용은 참조 하십시오. 트리 컨트롤 이미지를 나열 합니다..

참고 항목

참조

CTreeCtrl 사용

개념

컨트롤 (MFC)