DGListViewSetItemImage

리스트 뷰 항목에 할당된 이미지를 세트합니다.

    void DGListViewSetItemImage (
      short         dialId,
      short         item,
      short         listItem,
      short         imageType,
      const void*   imageData
    );

파라미터

dialId

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

item

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

listItem

리스트 항목의 1-기반 인덱스입니다. DG_LIST_TOP은 리스트의 1번째 항목을 지정하고, DG_LIST_BOTTOM은 리스트의 마지막 항목을 지정합니다. 모든 항목들의 이미지를 변경하려면 DG_ALL_ITEMS를 사용하십시오.

imageType

이미지의 타입입니다:

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

imageData

이미지 데이터입니다. imageType 파라미터에 따라 달라집니다.

설명

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

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

만약 어떠 이미지가 DGListViewSetImage에 의해 리스트 뷰 컨트롤과 연관되었다면, 모든 리스트 뷰 항목들은 DG_LVIT_IMAGEINDEX 이미지 타입을 가져야 합니다. 즉, 모든 리스트 뷰 항목 이미지들은 그 이미지의 서브 이미지들입니다. 그러나, 만약 리스트 뷰와 연관된 이미지가 없다면, 이 이미지 타입은 사용할 수 없습니다.

리스트 뷰 컨트롤 항목의 이미지는 DGListViewSetItemImage를 이용하여 이미지 데이터로 세트하거나, DGListViewSetItemImageId 또는 DGListViewSetItemImageResource를 이용하여 리소스 ID로 세트할 수 있습니다. 만약 이미지를 DGListViewSetItemImage로 세트했다면, DGListViewGetItemImage로 이미지 데이터를 가져올 수 있습니다. 이 경우 DGListViewGetItemImageId는 DG_NO_IMAGE를 리턴하고, DGListViewGetItemImageResource는 InvalidResModule을 리턴합니다.

요구사항

버전: DG 2.2.0 또는 이후

헤더: DG.h

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

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

참고사항

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