DGTreeViewGetItemIconId

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

    short DGTreeViewGetItemIconId (
      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	항목의 상태 아이콘입니다.

리턴 값

지정한 트리 뷰 항목의 아이콘 ID입니다. iconType 파라미터에 따라 달라집니다. 만약 지정한 트리 뷰 항목이 지정한 타입의 아이콘을 포함하지 않거나, 아이콘을 DGTreeViewSetItemIcon으로 세트했거나, 함수 파라미터들이 올바르지 않으면 DG_NO_ICON을 리턴합니다.

설명

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

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

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

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

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

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

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

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

참고사항

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