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 提供的圖片物件會實作 IPicture 和 IPictureDisp 介面的完整語意。
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ocidl.h |