DGTreeViewGetItemIcon

트리 뷰 항목의 상태 아이콘 또는 일반 아이콘의 아이콘 데이터를 가져옵니다.

    const void* DGTreeViewGetItemIcon (
      short  dialId,
      short  item,
      int32  treeItem,
      short  iconType
    );

파라미터

dialId

다이얼로그 또는 탭 페이지의 ID입니다. DG_TOP_MODAL은 최상위 Modal 다이얼로그를 지정합니다.

 

item

다이얼로그 항목의 1-기반 인덱스입니다.

 

treeItem

트리 뷰 항목의 ID입니다.

 

iconType

트리 뷰 항목의 쿼리된 아이콘의 타입입니다:

값	의미
DG_TVIT_NORMAL	항목의 일반 아이콘입니다.
DG_TVIT_STATE	항목의 상태 아이콘입니다.

리턴 값

지정한 트리 뷰 항목의 아이콘 데이터는 iconType 파라미터에 따라 달라집니다. (void*로 캐스팅할 것)

아이콘 데이터는 다음과 같습니다:

 Macintosh 전용: 

아이콘의 NSImage* 포인터, void*로 캐스팅할 것.

 Windows 전용: 

아이콘의 HICON 핸들, void*로 캐스팅할 것.

만약 지정한 트리 뷰 항목이 지정한 타입의 아이콘을 포함하지 않거나, 아이콘을 DGTreeViewSetItemIconId 또는 DGTreeViewSetItemIconResource로 세트했거나, 함수 파라미터들이 올바르지 않으면 NULL을 리턴합니다.

설명

트리 뷰 항목은 2가지 타입의 아이콘을 가질 수 있습니다: 상태 아이콘과 일반 아이콘. 아이콘들은 항상 항목 텍스트의 왼쪽에 있습니다. 만약 트리 뷰가 2가지 타입의 아이콘들을 모두 갖고 있다면, 상태 아이콘이 가장 왼쪽에 있습니다.

트리 뷰에서 서로 다른 상태 아이콘들의 개수는 12개까지 제한되어 있습니다. 일반 아이콘들의 경우 그러한 제한이 없습니다.

트리 뷰 항목의 아이콘을 세트하는 2가지 방법이 있습니다. 첫째는 DGTreeViewSetItemIconId 또는 DGTreeViewSetItemIconResource를 이용하여 리소스 ID로 아이콘을 지정하는 것입니다. 둘째는 DGTreeViewSetItemIcon을 이용하여 아이콘 데이터로 아이콘을 지정하는 것입니다. 만약 아이콘을 DGTreeViewSetItemIcon으로 세트했다면, 아이콘 데이터는 DGTreeViewGetItemIcon으로 가져올 수 있습니다. 이 경우 DGTreeViewGetItemIconId는 DG_NO_ICON을 리턴합니다.

만약 아이콘을 아직 세트하지 않았다면, 항목의 내용을 왼쪽으로 이동시키는 대신 빈 영역이 표시됩니다.

리소스 또는 DGTreeViewSetIconSize를 호출하여 크기를 0으로 설정하여 아이콘 타입들 중 하나를 생략할 수 있습니다. 이 설정들은 전체 트리 뷰에 적용됩니다. 즉, 모든 트리 항목들입니다.

요구사항

버전: DG 2.2.0 또는 이후

헤더: DG.h

라이브러리 가져오기: DG.lib [WIN]

모듈: DGLib [MAC], DG.dll [WIN]

참고사항

DG 함수, 트리 뷰, DGTreeViewSetItemIcon
DGTreeViewGetItemIconId, DGTreeViewGetItemIconResource
DGTreeViewSetItemIconId, DGTreeViewSetItemIconResource
DGTreeViewGetIconSize, DGTreeViewSetIconSize