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がオプションの値として指定されている場合、リボン フレームワークは IUIImage オブジェクトを介してビットマップ (HBITMAP) へのハンドルを所有し、フレームワークで不要になったときに解放します。
メモ このオプションを選択すると、リボン ホスト アプリケーションがアプリケーション UI 内の別の場所で同じ HBITMAP を安全に参照できなくなります。
|
| UI_OWNERSHIP_COPY | UI_OWNERSHIP_COPYがオプションの値として指定されている場合、ホスト アプリケーションは HBITMAP を所有し、UI の他の場所で使用するために同じ HBITMAP を参照できます。
メモ このオプションでは、ホスト アプリケーションで HBITMAP を解放する必要があります。
|
[out] image
種類: IUIImage**
このメソッドが戻るときに、 IUIImage オブジェクトを受け取るポインター変数のアドレスを格納します。
戻り値
型: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
解説
このファクトリ メソッドは、アプリケーションがイメージ リソースを動的に生成し、新しい HBITMAP をリボンに渡す場合に便利です。たとえば、Windows イメージング コンポーネント (WIC) を介してポータブル ネットワーク グラフィックス (PNG) を読み込む場合や 、CreateDIBSection を 使用してスタイル ギャラリー内の新しいスタイルのイメージを作成する場合などです。
このメソッドは、従来のツール バー イメージ ストリップなど、リボンによって古い形式でレンダリングされていない既存のビットマップ イメージを必要とするアプリケーションにも役立ちます。
リボン が 既存のアプリケーションに実装されており、最小限のコード変更が必要な場合は、 オプション の値としてUI_OWNERSHIP_COPYを指定します。 このメソッドは、追加のイメージに余分なメモリを使用します。
メモリ使用量を最小限に抑えるためのオプションの値として、UI_OWNERSHIP_TRANSFERを指定します。
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | uiribbon.h |
| [DLL] | Mshtml.dll |