IImageList::Add 메서드(commoncontrols.h)

이미지 목록에 하나의 이미지 또는 여러 이미지를 추가합니다.

구문

HRESULT Add(
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask,
  [out]          int     *pi
);

매개 변수

[in] hbmImage

형식: HBITMAP

이미지 또는 이미지가 포함된 비트맵에 대한 핸들입니다. 이미지 수는 비트맵의 너비에서 유추됩니다.

[in, optional] hbmMask

형식: HBITMAP

마스크를 포함하는 비트맵에 대한 핸들입니다. 이미지 목록과 함께 마스크를 사용하지 않으면 이 매개 변수는 무시됩니다.

[out] pi

형식: int*

이 메서드가 반환되면 첫 번째 새 이미지의 인덱스에 대한 포인터가 포함됩니다. 메서드가 새 이미지를 성공적으로 추가하지 못하면 이 값은 -1입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

IImageList::Add 는 비트맵을 내부 데이터 구조에 복사합니다. 메서드가 반환된 후 DeleteObject 함수를 사용하여 hbmImage 및 hbmMask 를 삭제해야 합니다.

IImageList::Add를 사용하려면 매니페스트에 Comctl32.dll 버전 6을 지정합니다. 매니페스트에 대한 자세한 내용은 시각적 스타일 사용을 참조하세요.

요구 사항