DGListViewGetItemImage

리스트 뷰 항목에 할당된 이미지 데이터를 가져옵니다.

    const void* DGListViewGetItemImage (
      short  dialId,
      short  item,
      short  listItem
);

파라미터

dialId: 다이얼로그 또는 탭 페이지의 ID입니다. DG_TOP_MODAL은 최상위 Modal 다이얼로그를 지정합니다.
item: 다이얼로그 항목의 1-기반 인덱스입니다.
listItem: 리스트 항목의 1-기반 인덱스입니다.

리턴 값

이미지의 타입에 따라 달라지는 지정한 리스트 뷰 항목의 이미지 데이터입니다. (void*로 캐스팅할 것) 지정한 리스트 뷰 항목의 이미지를 DGListViewSetItemImageId 또는 DGListViewSetItemImageResource로 세트했거나, DGListViewSetImage로 이미지를 리스트 뷰 컨트롤과 연관시켰거나, 함수 파라미터들이 올바르지 않을 때 NULL을 리턴합니다.

이미지 데이터는 이미지의 타입에 따라 달라집니다:

imageType	imageData
`DG_LVIT_NOIMAGE`	`NULL` - 이 항목에 대하여 정의된 이미지가 없습니다.
`DG_LVIT_ICON`	Macintosh 전용: 아이콘, *`NSImage`로 참조됨, `void`로 캐스팅할 것. Windows 전용:* 아이콘, `HICON`로 참조됨, *`void`**로 캐스팅할 것.
`DG_LVIT_PICTURE`	Macintosh 전용: 그림, *`NSImage`로 참조됨, `void`로 캐스팅할 것. Windows 전용:* 그림, `HBITMAP`로 참조됨, *`void`**로 캐스팅할 것.
Windows 전용:
`DG_LVIT_DIBITMAP`	장치 독립 비트맵, *`BITMAPINFO`로 참조됨, `void`*로 캐스팅할 것.

설명

리스트 뷰 항목 이미지를 정의하는 2가지 방법이 있습니다:

DGListViewSetItemImage, DGListViewSetItemImageId 또는 DGListViewSetItemImageResource를 이용하여 항목들에게 이미지를 개별적으로 할당합니다. 이 이미지들은 각 리스트 뷰 항목에 대하여 서로 다른 타입과 크기를 가질 수 있습니다. 이 항목 지정 이미지 데이터, 이미지 ID, 또는 이미지 리소스 모듈을 가져오려면 DGListViewGetItemImage, DGListViewGetItemImageId 또는 DGListViewGetItemImageResource를 사용하십시오.
DGListViewSetImage, DGListViewSetImageId 또는 DGListViewSetImageResource를 이용하여 하나의 이미지를 리스트 뷰 자체에 연관시키고, 행(row) 수와 서브 이미지의 총 개수를 제공하여 큰 이미지를 동일한 크기의 작은 서브 이미지들로 나눕니다. DGListViewSetItemImageIndex를 이용하여 각 서브 이미지를 리스트 뷰 항목에 할당합니다. 함수의 이미지 인덱스 파라미터는 서브 이미지의 1-기반 row-by-row 인덱스입니다 이 경우, 항목의 이미지의 타입은 DG_LVIT_IMAGEINDEX가 될 것입니다.

만약 DGListViewSetImage로 이미지를 리스트 뷰 컨트롤과 연관시켰다면, 모든 리스트 뷰 항목들은 DG_LVIT_IMAGEINDEX 이미지 타입을 가져야 합니다. 즉, 모든 리스트 뷰 항목 이미지들은 이미지의 서브 이미지들입니다.

이미지의 타입은 DGListViewGetItemImageType으로 가져올 수 있습니다.

요구사항

버전: DG 2.2.0 또는 이후

헤더: DG.h

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

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

참고사항

DG 함수, 리스트 뷰, DGListViewSetItemImage
DGListViewGetItemImageId, DGListViewSetItemImageId, DGListViewGetItemImageResource, DGListViewSetItemImageResource, DGListViewGetItemImageIndex, DGListViewSetItemImageIndex, DGListViewGetItemImageType
DGListViewGetImage, DGListViewSetImage, DGListViewGetImageId, DGListViewSetImageId, DGListViewGetImageResource, DGListViewSetImageResource, DGListViewGetImageSize, DGListViewSetImageSize, DGListViewGetImageLayout, DGListViewGetImageType