IPicture-Schnittstelle (ocidl.h)

Verwaltet ein Bildobjekt und seine Eigenschaften. Bildobjekte bieten eine sprachneutrale Abstraktion für Bitmaps, Symbole und Metadateien. Wie beim Standardschriftartobjekt stellt das System eine Standardimplementierung des Bildobjekts bereit. Die primären Schnittstellen sind IPicture und IPictureDisp, wobei letztere von IDispatch abgeleitet werden, um den Zugriff auf die Eigenschaften des Bilds über Automation zu ermöglichen. Ein Bildobjekt wird mit OleCreatePictureIndirect erstellt.

Das Bildobjekt unterstützt auch die ausgehende Schnittstelle IPropertyNotifySink, sodass ein Client bestimmen kann, wann sich die Bildeigenschaften ändern. Da das Bildobjekt mindestens eine ausgehende Schnittstelle unterstützt, implementiert es zu diesem Zweck auch IConnectionPointContainer und die zugehörigen Schnittstellen.

Das Bildobjekt unterstützt auch IPersistStream, sodass es sich selbst aus einer instance von IStream speichern und laden kann. Ein Objekt, das ein Bildobjekt intern verwendet, würde normalerweise das Bild im Rahmen der objekteigenen Persistenzbehandlung speichern und laden. Die Funktion OleLoadPicture vereinfacht die Erstellung eines Bildobjekts basierend auf Streaminhalten.

Vererbung

Die IPicture-Schnittstelle erbt von der IUnknown-Schnittstelle . IPicture verfügt auch über folgende Arten von Membern:

Methoden

Die IPicture-Schnittstelle verfügt über diese Methoden.

IPicture::get_Attributes Ruft den aktuellen Satz der Bitattribute des Bilds ab.
IPicture::get_CurDC Ruft das Handle des aktuellen Gerätekontexts ab. Diese Eigenschaft ist nur für Bitmapbilder gültig.
IPicture::get_Handle Ruft das Handle für das in diesem Bildobjekt verwaltete Bild an einer angegebenen Position ab.
IPicture::get_Height Ruft die aktuelle Höhe des Bilds im Bildobjekt ab.
IPicture::get_hPal Ruft eine Kopie der Palette ab, die derzeit vom Bildobjekt verwendet wird.
IPicture::get_KeepOriginalFormat Ruft den aktuellen Wert der KeepOriginalFormat-Eigenschaft des Bilds ab.
IPicture::get_Type Ruft den aktuellen Typ des Bilds ab, das im Bildobjekt enthalten ist.
IPicture::get_Width Ruft die aktuelle Breite des Bilds im Bildobjekt ab.
IPicture::P ictureChanged Benachrichtigt das Bildobjekt, dass seine Bildressource geändert wurde. Diese Methode ruft nur IPropertyNotifySink::OnChanged mit DISPID_PICT_HANDLE für alle verbundenen Senken auf.
IPicture::p ut_KeepOriginalFormat Legt den Wert der KeepOriginalFormat-Eigenschaft des Bilds fest.
IPicture::Render Rendert (zeichnet) einen angegebenen Teil des Bilds, der durch den Offset (xSrc,ySrc) des Quellbilds und die zu kopierenden Dimensionen (cxSrc,xySrc) definiert ist.
IPicture::SaveAsFile Speichert die Daten des Bilds in einem Stream im gleichen Format, wie es sich selbst in einer Datei speichern würde. Bitmaps verwenden das BMP-Dateiformat, Metadateien das WMF-Format und symbolieren das ICO-Format.
IPicture::SelectPicture Wählt ein Bitmapbild in einem bestimmten Gerätekontext aus und gibt den Gerätekontext, in dem das Bild zuvor ausgewählt wurde, sowie das GDI-Handle des Bilds zurück. Diese Methode funktioniert in Verbindung mit IPicture::get_CurDC.
IPicture::set_hPal Weist dem im Bildobjekt enthaltenen Bild eine GDI-Palette zu.

Hinweise

Jede Eigenschaft in der IPicture-Schnittstelle enthält eine get_PropertyName-Methode , wenn die -Eigenschaft lesezugriff unterstützt, und eine put_PropertyName-Methode , wenn die -Eigenschaft schreibzugriff unterstützt.

Eigenschaft	Typ	Access	Beschreibung
Handle	OLE_HANDLE (int)	R	Das Windows GDI-Handle des Bilds
hPal	OLE_HANDLE (int)	RW	Das Windows-Handle der Palette, die vom Bild verwendet wird.
Typ	short	R	Der Bildtyp (siehe PICTYPE).
Breite	OLE_XSIZE_HIMETRIC (lang)	R	Die Breite des Bilds.
Höhe	OLE_YSIZE_HIMETRIC (lang)	R	Die Höhe des Bilds.
CurDC	HDC	R	Der aktuelle Gerätekontext.
KeepOriginalFormat	BOOL	RW	Bei TRUE behält das Bildobjekt den gesamten ursprünglichen Zustand des Bilds im Arbeitsspeicher bei. Wenn FALSE, wird jeder Zustand verworfen, der nicht auf den Computer des Benutzers anwendbar ist.
Attribute	DWORD	R	Verschiedene Bitattribute des Bilds.

 

OLE-Implementierung

Bildobjekte bieten eine sprachneutrale Abstraktion für Bitmaps, Symbole und Metadateien. Wie beim Standardschriftartobjekt stellt das System eine Standardimplementierung des Bildobjekts bereit. Die primären Schnittstellen sind IPicture und IPictureDisp. Ein Bildobjekt wird mit OleCreatePictureIndirect erstellt und unterstützt sowohl die IPicture - als auch die IPictureDisp-Schnittstelle .

Das von OLE bereitgestellte Bildobjekt implementiert die vollständige Semantik der Schnittstellen IPicture und IPictureDisp .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

Ipicturedisp