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

기존의 두 이미지를 결합하여 새 이미지를 만듭니다. 또한 이 메서드는 이미지를 저장할 새 이미지 목록을 만듭니다.

구문

HRESULT Merge(
  [in]  int      i1,
  [in]  IUnknown *punk2,
  [in]  int      i2,
  [in]  int      dx,
  [in]  int      dy,
  [out] REFIID   riid,
  [out] void     **ppv
);

매개 변수

[in] i1

형식: int

첫 번째 기존 이미지의 인덱스를 포함하는 int 형식의 값입니다.

[in] punk2

형식: IUnknown*

두 번째 이미지가 포함된 이미지 목록의 IUnknown 인터페이스에 대한 포인터입니다.

[in] i2

형식: int

두 번째 기존 이미지의 인덱스를 포함하는 int 형식의 값입니다.

[in] dx

형식: int

첫 번째 이미지를 기준으로 두 번째 이미지 오프셋의 x 구성 요소를 포함하는 int 형식의 값입니다.

[in] dy

형식: int

첫 번째 이미지를 기준으로 두 번째 이미지의 오프셋의 y 구성 요소를 포함하는 int 형식의 값입니다.

[out] riid

형식: REFIID

새 이미지 목록에 대한 인터페이스의 IID입니다.

[out] ppv

형식: PVOID*

새 이미지 목록의 인터페이스에 대한 원시 포인터입니다.

반환 값

형식: HRESULT

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

설명

새 이미지는 첫 번째 이미지 위에 투명하게 그려진 두 번째 이미지로 구성됩니다. 새 이미지의 마스크는 두 기존 이미지의 마스크를 비트 OR 연산자를 결합하여 가져옵니다.

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

요구 사항

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