Share via

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

  • 아티클

이미지 목록에 있는 이미지를 새 이미지로 바꿉니다.

구문

HRESULT Replace(
  [in]           int     i,
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask
);

매개 변수

[in] i

형식: int

바꿀 이미지의 인덱스를 포함하는 int 형식의 값입니다.

[in] hbmImage

형식: HBITMAP

이미지를 포함하는 비트맵에 대한 핸들입니다.

[in, optional] hbmMask

형식: HBITMAP

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

반환 값

형식: HRESULT

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

설명

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

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 commoncontrols.h
DLL Comctl32.dll(버전 6.0 이상)