TreeView_SetCheckState 매크로(commctrl.h)

항목의 상태 이미지를 "checked" 또는 "unchecked"로 설정합니다. TVM_SETITEM 메시지를 직접 사용할 수도 있습니다.

구문

void TreeView_SetCheckState(
   hwndTV,
   hti,
   fCheck
);

매개 변수

hwndTV

형식: HWND

트리 뷰 컨트롤에 대한 핸들입니다.

hti

형식: HTREEITEM

항목에 대한 핸들입니다.

fCheck

형식: BOOL

표시되는 상태 이미지를 나타내는 값입니다. fCheck를 TRUE로 설정하여 선택된 상태 이미지를 표시하거나 FALSE를 설정하여 선택되지 않은 이미지를 표시합니다.

반환 값

없음

설명

트리 뷰 컨트롤에는 두 개의 이미지 목록이 있을 수 있습니다. 일반 이미지 목록에는 선택한 이미지, 선택되지 않은 이미지 및 오버레이 이미지가 저장됩니다. 확인란은 상태 이미지 목록에 저장되고 해당 일반 이미지의 왼쪽에 표시됩니다. 상태 이미지는 하나의 기반 인덱스로 지정됩니다. 인덱스 0은 상태 이미지가 없음을 나타냅니다. 트리 뷰 이미지를 처리하는 방법에 대한 자세한 내용은 트리 뷰 이미지 Lists 참조하세요.

사용자 고유의 상태 이미지를 정의하려는 경우 이 매크로는 선택됨 및 선택되지 않은 이미지에 표준 이미지 목록과 동일한 인덱스가 있다고 가정합니다. 1은 선택하지 않은 경우 2입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	commctrl.h