IPicture 介面 (ocidl.h)

管理圖片物件及其屬性。 圖片物件提供位圖、圖示和元文件的語言中性抽象概念。 如同標準字型對象,系統會提供圖片對象的標準實作。 其主要介面是 IPicture 和 IPictureDisp,後者衍生自 IDispatch,可透過自動化提供圖片屬性的存取權。 使用 OleCreatePictureIndirect 建立圖片物件。

圖片物件也支持傳出介面 IPropertyNotifySink,因此用戶端可以判斷圖片屬性何時變更。 因為圖片物件至少支援一個傳出介面,所以也會針對此目的實作 IConnectionPointContainer 及其相關聯的介面。

圖片物件也支援 IPersistStream ,以便從 IStream 實例儲存和載入本身。 在內部使用圖片對象的 物件通常會儲存並載入圖片,做為物件本身持續性處理的一部分。 OleLoadPicture 函式會根據數據流內容簡化圖片物件的建立。

繼承

IPicture 介面繼承自 IUnknown 介面。 IPicture 也有下列類型的成員:

方法

IPicture 介面具有這些方法。

 
IPicture::get_Attributes

擷取圖片位屬性的目前集合。
IPicture::get_CurDC

擷取目前裝置內容的句柄。 此屬性僅適用於點陣圖圖片。
IPicture::get_Handle

擷取此圖片物件內所管理圖片的句柄至指定的位置。
IPicture::get_Height

擷取圖片對象中圖片的目前高度。
IPicture::get_hPal

擷取圖片物件目前使用的調色盤復本。
IPicture::get_KeepOriginalFormat

擷取圖片 KeepOriginalFormat 屬性的目前值。
IPicture::get_Type

擷取圖片物件中包含的圖片目前類型。
IPicture::get_Width

擷取圖片對象中圖片的目前寬度。
IPicture::P ictureChanged

通知圖片對象其圖片資源已變更。 此方法只會針對任何連線的接收呼叫 IPropertyNotifySink::OnChanged 與 DISPID_PICT_HANDLE。
IPicture::p ut_KeepOriginalFormat

設定圖片的 KeepOriginalFormat 屬性的值。
IPicture::Render

轉譯 (繪製) 來源圖片的位移 (xSrc,ySrc) 所定義之圖片的指定部分,以及要複製 (cxSrc,xySrc) 的維度。
IPicture::SaveAsFile

將圖片的數據儲存成數據流,格式與它本身儲存成檔案的格式相同。 點陣圖會使用 BMP 檔案格式、元檔 WMF 格式,以及圖示 ICO 格式。
IPicture::SelectPicture

在指定的裝置內容中選取位圖圖片,並傳回先前選取圖片的裝置內容,以及圖片的 GDI 句柄。 這個方法可與 IPicture::get_CurDC搭配運作。
IPicture::set_hPal

將 GDI 調色盤指派給圖片物件中包含的圖片。

備註

如果屬性支援讀取許可權,則 IPicture 介面中的每個屬性都包含 一個get_PropertyName 方法,如果屬性支援寫入存取 ,則為put_PropertyName 方法。

屬性 類型 存取 描述
Handle OLE_HANDLE (int) R 圖片的 Windows GDI 句柄
hPal OLE_HANDLE (int) RW 圖片所使用的調色盤 Windows 句柄。
類型 short R 圖片類型 (請參閱 PICTYPE) 。
寬度 OLE_XSIZE_HIMETRIC (長) R 圖片的寬度。
高度 OLE_YSIZE_HIMETRIC (長) R 圖片的高度。
CurDC HDC R 目前的裝置內容。
KeepOriginalFormat Bool RW 如果 為 TRUE,圖片對象會維護記憶體中圖片的整個原始狀態。 如果 為 FALSE,則會捨棄不適用於用戶電腦的任何狀態。
屬性 DWORD R 圖片的其他位屬性。
 

OLE 實作

圖片物件提供位圖、圖示和元文件的語言中性抽象概念。 如同標準字型對象,系統會提供圖片對象的標準實作。 其主要介面是 IPictureIPictureDisp。 圖片物件是使用 OleCreatePictureIndirect 建立,並支援 IPicture 和 IPictureDisp 介面。

OLE 提供的圖片物件會實作 IPicture 和 IPictureDisp 介面的完整語意。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 ocidl.h

另請參閱

IPictureDisp