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，而且能夠參考相同的 HBITMAP，以在 UI 中的其他位置使用。注意此選項負責在主應用程式上釋放 HBITMAP。

[out] image

類型： IUIImage**

當這個方法傳回時，會包含接收 IUIImage 物件的指標變數位址。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

當應用程式動態產生影像資源，而且想要將新的 HBITMAP 傳遞至功能區時，這個 Factory 方法很有用，例如，透過 Windows 映像元件 (PNG) 載入可攜式網狀圖形， (WIC) 或使用 CreateDIBSection 在樣式庫中建立新樣式的影像。

這個方法也適用于需要功能區尚未過時之預先存在的點陣圖影像的應用程式，例如舊版工具列影像帶。

如果功能區是在現有應用程式中實作，而且需要最少的程式碼變更，請指定 UI_OWNERSHIP_COPY 做為選項的值。這個方法會針對其他映射使用額外的記憶體。

指定 UI_OWNERSHIP_TRANSFER 做為選項的值，以將記憶體使用量降到最低。