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

오버레이 마스크로 사용되는 이미지 목록에 지정된 이미지를 추가합니다. 이미지 목록에는 공용 컨트롤 버전 4.70에서 최대 4개, 버전 4.71 이상에서 최대 15개의 오버레이 마스크를 포함할 수 있습니다. 메서드는 지정된 이미지에 오버레이 마스크 인덱스를 할당합니다.

구문

HRESULT SetOverlayImage(
  [in] int iImage,
  [in] int iOverlay
);

매개 변수

[in] iImage

형식: int

이미지 목록에 있는 이미지의 인덱스(0부터 시작)를 포함하는 int 형식의 값입니다. 이 인덱스는 오버레이 마스크로 사용할 이미지를 식별합니다.

[in] iOverlay

형식: int

오버레이 마스크의 1 기반 인덱스를 포함하는 int 형식의 값입니다.

반환 값

형식: HRESULT

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

설명

오버레이 마스크는 다른 이미지 위에 투명하게 그려진 이미지입니다. 이미지 위에 오버레이 마스크를 그리려면 IImageList::D raw를 호출합니다. 이러한 함수의 fStyle 매개 변수는 INDEXTOOVERLAYMASK 매크로를 사용하여 오버레이 마스크 인덱스를 지정할 수 있습니다.

이 메서드에 대한 호출은 실패하고 마스크를 사용하여 이미지 목록을 만들지 않는 한 E_INVALIDARG 반환합니다.

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

요구 사항

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