DGListViewSetImage

리스트 뷰 컨트롤과 연관된 이미지를 세트합니다.

    void DGListViewSetImage (
      short         dialId,
      short         item,
      short         imageType,
      const void*   imageData,
      short         nImages,
      short         nRows
    );

파라미터

dialId

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

item

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

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 파라미터에 따라 달라집니다.

nImages

이미지 안의 서브 이미지들의 개수입니다.

nRows

이미지 안의 서브 이미지들의 행들의 개수입니다.

설명

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

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

만약 DGListViewSetImage로 이미지를 리스트 뷰 컨트롤과 연관시켰다면, 모든 리스트 뷰 항목들은 DG_LVIT_IMAGEINDEX 이미지 타입을 가져야 합니다, 즉, 모든 리스트 뷰 항목 이미지들은 이 이미지의 서브 이미지들입니다. (모든 항목 이미지들은 DGListViewSetItemImageIndex 함수를 이용하여 항목에 할당되어야 합니다) 만약 리스트 뷰와 연관된 이미지가 없다면, DGListViewSetItemImageIndex를 사용할 수 없습니다.

리스트 뷰 컨트롤의 이미지를 세트할 때 DGListViewSetImage를 이용하여 이미지 데이터로 세트하거나, DGListViewSetImageId 또는 DGListViewSetImageResource를 이용하여 리소스 ID로 세트할 수 있습니다. 만약 DGListViewSetImage로 이미지를 세트했다면, DGListViewGetImage로 이미지 데이터를 가져올 수 있습니다. 이 경우 DGListViewGetImageId는 DG_NO_IMAGE를 리턴하고, DGListViewGetImageResource는 InvalidResModule을 리턴합니다.

요구사항

버전: DG 2.2.0 또는 이후

헤더: DG.h

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

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

참고사항

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