DGTreeViewSetItemIconId

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

    void DGTreeViewSetItemIconId (
      short  dialId,
      short  item,
      Int32  treeItem,
      short  iconType,
      short  iconId
    );

파라미터

dialId

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

 

item

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

 

treeItem

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

 

iconType

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

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

 

iconId

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

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

 

값	의미	Macintosh	Windows
DG_NO_ICON	아이콘 없음, 비어 있는 공간.
DG_ERROR_ICON	오류 아이콘.
DG_INFORMATION_ICON	정보 아이콘.
DG_WARNING_ICON	경고 아이콘.
DG_FILE_ICON	파일 아이콘.
DG_TEXTFILE_ICON	텍스트 파일 아이콘.
DG_FOLDER_ICON	폴더 아이콘.
DG_FOLDEROPEN_ICON	열린 폴더 아이콘.
DG_MYDOCFOLDER_ICON	내 문서 폴더 아이콘.
DG_FAVORITES_ICON	즐겨찾기 아이콘.
DG_FLOPPY_ICON	플로피 아이콘.
DG_CDDRIVE_ICON	CD 드라이브 아이콘.
DG_HDD_ICON	HDD 아이콘.
DG_NETDRIVE_ICON	네트워크 드라이브 아이콘.
DG_DESKTOP_ICON	데스크톱 아이콘.
DG_RECYCLEBIN_ICON	휴지통 아이콘.
DG_ENTIRENETWORK_ICON	전체 네트워크 아이콘.

설명

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

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

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

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

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

DGTreeViewSetItemIconId 함수는 트리 뷰 항목을 포함하는 다이얼로그 또는 탭 페이지와 연관된 리소스 모듈을 사용합니다. 만약 아이콘이 다이얼로그와 동일한 리소스 모듈 안에 있다고 확신한다면 이 함수를 사용하십시오. 그러나 만약 아이콘의 리소스 모듈이 다이얼로그의 리소스 모듈과 다르다면, 아이콘을 포함하는 리소스 모듈을 세트하기 위해 DGTreeViewSetItemIconResource 함수를 사용하십시오. 다이얼로그의 리소스 모듈은 각각 DGSetDialogResourceModule과 DGGetDialogResourceModule로 세트하거나 가져올 수 있습니다.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

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

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

참고사항

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