DGTreeViewSetItemIconResource

트리 뷰 항목의 상태 아이콘 또는 일반 아이콘의 아이콘 ID와 해당 아이콘의 리소스 모듈 ID를 세트합니다.

    void DGTreeViewSetItemIconResource (
      short        dialId,
      short        item,
      Int32        treeItem,
      short        iconType,
      GSResModule  resModule,
      short        iconId
    );

파라미터

dialId

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

 

item

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

 

treeItem

트리 뷰 항목의 ID입니다. 주어진 타입의 아이콘들을 모두 변경하려면 DG_ALL_ITEMS를 사용하십시오.

 

iconType

트리 뷰 항목에서 변경할 아이콘의 타입입니다:

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

 

resModule

아이콘을 포함하는 리소스 모듈 ID입니다.

 

iconId

트리 뷰 항목의 아이콘들 중 하나에 대한 새로운 아이콘 ID입니다. iconType 파라미터에 따라 달라집니다.

iconID는 아무 양의 리소스 ID 또는 다음과 같이 미리 정의된 상수들 중 하나가 될 수 있습니다:

 

값	의미	Macintosh	Windows
DG_NO_ICON	아이콘 없음, 비어 있는 공간.
DG_TVIC_FLOPPY	플로피 아이콘.
DG_TVIC_HDDRIVE	HDD 아이콘.
DG_TVIC_CDDRIVE	CD 드라이브 아이콘.
DG_TVIC_FOLDER	폴더 아이콘.
DG_TVIC_FILE	파일 아이콘.

설명

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

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

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

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

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

만약 아이콘이 다이얼로그의 리소스 모듈 안에 있다면, 아이콘을 DGTreeViewSetItemIconId로도 세트할 수 있습니다. 다이얼로그의 리소스 모듈은 각각 DGSetDialogResourceModule과 DGGetDialogResourceModule로 세트하거나 가져올 수 있습니다.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

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

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

참고사항

DG 함수, 트리 뷰, DGTreeViewGetItemIconResource
DGTreeViewSetItemIcon, DGTreeViewSetItemIconId
DGTreeViewGetItemIcon, DGTreeViewGetItemIconId
DGTreeViewGetIconSize, DGTreeViewSetIconSize, DGGetDialogResourceModule, DGSetDialogResourceModule