IUIImageFromBitmap::CreateImage 메서드(uiribbon.h)
비트맵 이미지에서 IUIImage 개체를 만듭니다.
구문
HRESULT CreateImage(
[in] HBITMAP bitmap,
[in] UI_OWNERSHIP options,
[out] IUIImage **image
);
매개 변수
[in] bitmap
형식: HBITMAP
이미지를 포함하는 비트맵에 대한 핸들입니다.
[in] options
형식: UI_OWNERSHIP
이미지를 만드는 소유권 조건 입니다.
| 값 | 의미 |
|---|---|
| UI_OWNERSHIP_TRANSFER | UI_OWNERSHIP_TRANSFER옵션 값으로 지정된 경우 Ribbon 프레임워크는 IUIImage 개체를 통해 비트맵(HBITMAP)에 대한 핸들을 소유하고 프레임워크에 더 이상 필요하지 않은 경우 해제합니다.
참고 이 옵션을 사용하면 리본 호스트 애플리케이션이 애플리케이션 UI의 다른 곳에서 동일한 HBITMAP를 안전하게 참조할 수 없습니다.
|
| UI_OWNERSHIP_COPY | UI_OWNERSHIP_COPY옵션 값으로 지정된 경우 호스트 애플리케이션은 HBITMAP를 소유하고 UI의 다른 곳에서 사용하기 위해 동일한 HBITMAP를 참조할 수 있습니다.
참고 이 옵션은 호스트 애플리케이션에서 HBITMAP를 해제할 책임이 있습니다.
|
[out] image
형식: IUIImage**
이 메서드가 반환될 때 에는 IUIImage 개체를 수신하는 포인터 변수의 주소가 포함됩니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 팩터리 메서드는 애플리케이션이 이미지 리소스를 동적으로 생성하고 새 HBITMAP를 리본 메뉴에 전달하려는 경우에 유용합니다. 예를 들어 WIC(Windows 이미징 구성 요소)를 통해 PNG(이식 가능한 네트워크 그래픽)를 로드하거나 CreateDIBSection 을 사용하여 스타일 갤러리에서 새 스타일에 대한 이미지를 만듭니다.
이 메서드는 리본에서 사용되지 않는 기존 비트맵 이미지(예: 레거시 도구 모음 이미지 스트립)가 필요한 애플리케이션에도 유용합니다.
리본이 기존 애플리케이션에서 구현되고 최소한의 코드 변경이 필요한 경우 옵션 값으로 UI_OWNERSHIP_COPY 지정합니다. 이 메서드는 추가 이미지에 추가 메모리를 사용합니다.
메모리 사용량을 최소화하기 위한 옵션 값으로 UI_OWNERSHIP_TRANSFER 지정합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | uiribbon.h |
| DLL | Mshtml.dll |