Bildfunktionen
Windows GDI+ macht eine flache API verfügbar, die aus ca. 600 Funktionen besteht, die in Gdiplus.dll implementiert und in Gdiplusflat.h deklariert werden. Die Funktionen in der GDI+-API werden von einer Sammlung von ca. 40 C++-Klassen umschlossen. Es wird empfohlen, die Funktionen in der flachen API nicht direkt auf aufruft. Wenn Sie Aufrufe von GDI+, sollten Sie dazu die Methoden und Funktionen aufrufen, die von den C++-Wrappern bereitgestellt werden. Der Microsoft-Produktsupport bietet keine Unterstützung für Code, der die flache API direkt aufruft. Weitere Informationen zur Verwendung dieser Wrappermethoden finden Sie unter GDI+ Flat-API.
Die folgenden flachen API-Funktionen werden von der Image C++-Klasse umschlossen.
HatchBrush-Funktionen und entsprechende Wrappermethoden
| Flat-Funktion | Wrappermethode | Hinweise |
|---|---|---|
| GpStatus WINGDIPAPI GdipLoadImageFromStream(IStream * stream, GpImage * * image) |
Image::Image(IN IStream * stream, IN BOOL useEmbeddedColorManagement) | Erstellt ein Image-Objekt basierend auf einem Stream. Diese flache Funktion verwendet keine Bildfarbverwaltung (Image Color Management, ICM). |
| GpStatus WINGDIPAPI GdipLoadImageFromFile(GDIPCONST WCHAR * filename, GpImage * * image) |
Image::Image(IN const WCHAR * filename, IN BOOL useEmbeddedColorManagement) | Erstellt ein Image-Objekt basierend auf einer Datei. Diese flache Funktion verwendet keine ICM. |
| GpStatus WINGDIPAPI GdipLoadImageFromStreamICM(IStream * stream, GpImage * * image) |
Image::Image(IN IStream * stream, IN BOOL useEmbeddedColorManagement) | Erstellt ein Image-Objekt basierend auf einem Stream. Diese flache Funktion verwendet keine ICM. |
| GpStatus WINGDIPAPI GdipLoadImageFromFileICM(GDIPCONST WCHAR * filename, GpImage * * image) |
Image::Image(IN const WCHAR * filename, IN BOOL useEmbeddedColorManagement) | Erstellt ein Image-Objekt basierend auf einer Datei. Diese flache Funktion verwendet keine ICM. |
| GpStatus WINGDIPAPI GdipCloneImage(GpImage * image, GpImage * * cloneImage) |
Image * Image::Clone() | Erstellt ein neues Image-Objekt und initialisiert es mit dem Inhalt dieses Image-Objekts. |
| GpStatus WINGDIPAPI GdipDisposeImage(GpImage * image) |
Image::~Image() |
Gibt vom Image-Objekt verwendete Ressourcen frei. |
| GpStatus WINGDIPAPI GdipSaveImageToFile(GpImage * image, GDIPCONST WCHAR * filename, GDIPCONST CLSID * clsidEncoder, GDIPCONST EncoderParameters * encoderParams) |
Status Image::Save( IN const WCHAR * filename, IN const CLSID * clsidEncoder, IN const EncoderParameters * encoderParams ) | Speichert dieses Image in einer Datei. |
| GpStatus WINGDIPAPI GdipSaveImageToStream(GpImage * image, IStream * stream, GDIPCONST CLSID * clsidEncoder, GDIPCONST EncoderParameters * encoderParams) |
Status Image::Save( IN IStream * stream, IN const CLSID * clsidEncoder, IN const EncoderParameters * encoderParams ) | Speichert dieses Bild in einem Stream. |
| GpStatus WINGDIPAPI GdipSaveAdd(GpImage * image, GDIPCONST EncoderParameters * encoderParams) |
Status Image::SaveAdd( IN const EncoderParameters * encoderParams ) | Fügt einer Datei oder einem Stream, die in einem vorherigen Aufruf der Save-Methode angegeben wurde, einen Frame hinzu. Mit dieser Methode speichern Sie ausgewählte Rahmen eines Bilds mit mehreren Rahmen in einem anderen Bild mit mehreren Rahmen. |
| GpStatus WINGDIPAPI GdipSaveAddImage(GpImage * image, GpImage * newImage, GDIPCONST EncoderParameters * encoderParams) |
Statusbild::SaveAdd( IN Image * newImage, IN const EncoderParameters * encoderParams ) | Fügt einer Datei oder einem Stream, die in einem vorherigen Aufruf der Save-Methode angegeben wurde, einen Frame hinzu. |
| GpStatus WINGDIPAPI GdipGetImageGraphicsContext(GpImage-Bild, * GpGraphics-Grafiken) * * |
Graphics::Graphics(IN Image * image) | Erstellt ein Grafikobjekt, das einem Image-Objekt zugeordnet ist. |
| GpStatus WINGDIPAPI GdipGetImageBounds(GpImage * image, GpRectF * srcRect, GpUnit * srcUnit) |
Statusbild::GetBounds( OUT RectF * srcRect, OUT Unit * srcUnit ) | Ruft das umgebundene Rechteck für dieses Bild ab. |
| GpStatus WINGDIPAPI GdipGetImageDimension(GpImage * image, REAL * width, REAL * height) |
Statusbild::GetPhysicalDimension( OUT SizeF * size ) | Ruft die Breite und Höhe dieses Bilds ab. In der flachen Funktion entsprechen die Breiten- und Höhenparameter zusammen dem Size-Parameter in der Wrappermethode. |
| GpStatus WINGDIPAPI GdipGetImageType(GpImage * image, ImageType * type) |
ImageType Image::GetType() const | Ruft den Typ (Bitmap oder Metadatei) dieses Image-Objekts ab. |
| GpStatus WINGDIPAPI GdipGetImageWidth(GpImage * image, UINT * width) |
UINT Image::GetWidth() | Ruft die Breite dieses Bilds in Pixel ab. |
| GpStatus WINGDIPAPI GdipGetImageHeight(GpImage * image, UINT * height) |
UINT Image::GetHeight() | Ruft die Bildhöhe dieses Bilds in Pixel ab. |
| GpStatus WINGDIPAPI GdipGetImageHorizontalResolution(GpImage * image, REAL * resolution) |
REAL Image::GetHorizontalResolution() | Ruft die horizontale Auflösung dieses Bilds in Punkt pro Zoll ab. |
| GpStatus WINGDIPAPI GdipGetImageVerticalResolution(GpImage * image, REAL * resolution) |
REAL Image::GetVerticalResolution() | Ruft die vertikale Auflösung dieses Bilds in Punkt pro Zoll ab. |
| GpStatus WINGDIPAPI GdipGetImageFlags(GpImage * image, UINT * flags) |
UINT Image::GetFlags() | Ruft einen Satz von Flags ab, die bestimmte Attribute dieses Image-Objekts angeben. |
| GpStatus WINGDIPAPI GdipGetImageRawFormat(GpImage * image, GUID * format) |
Statusbild::GetRawFormat(OUT-GUID-Format) * | Ruft einen global eindeutigen Bezeichner (GUID) ab, der das Format dieses Image-Objekts identifiziert. GUIDs, die verschiedene Dateiformate identifizieren, werden in "Gdiplusimaging.h" definiert. |
| GpStatus WINGDIPAPI GdipGetImagePixelFormat(GpImage * image, PixelFormat * format) |
PixelFormat Image::GetPixelFormat() | Ruft das Pixelformat dieses Image-Objekts ab. |
| GpStatus WINGDIPAPI GdipGetImageThumbnail(GpImage * image, UINT thumbWidth, UINT thumbHeight, GpImage * * thumbImage, GetThumbnailImageAbort callback, VOID * callbackData) |
Image * Image::GetThumbnailImage( IN UINT thumbWidth, IN UINT thumbHeight, IN GetThumbnailImageAbort callback, IN VOID * callbackData ) | Ruft ein Miniaturbild aus diesem Image-Objekt ab. |
| GpStatus WINGDIPAPI GdipGetEncoderParameterListSize(GpImage * image, GDIPCONST CLSID * clsidEncoder, UINT * size) |
UINT Image::GetEncoderParameterListSize( IN const CLSID * clsidEncoder ) | Ruft die Größe der Parameterliste für einen angegebenen Bildencoder in Bytes ab. |
| GpStatus WINGDIPAPI GdipGetEncoderParameterList(GpImage * image, GDIPCONST CLSID * clsidEncoder, UINT size, EncoderParameters * buffer) |
Status Image::GetEncoderParameterList( IN const CLSID * clsidEncoder, IN UINT size, OUT EncoderParameters * buffer ) | Ruft eine Liste der Parameter ab, die von einem angegebenen Bildencoder unterstützt werden. |
| GpStatus WINGDIPAPI GdipImageGetFrameDimensionsCount(GpImage * image, UINT * count) |
UINT Image::GetFrameDimensionsCount() | Ruft die Anzahl der Rahmendimensionen in diesem Image-Objekt ab. |
| GpStatus WINGDIPAPI GdipImageGetFrameDimensionsList(GpImage * image, GUID * dimensionIDs, UINT count) |
Status Image::GetFrameDimensionsList( OUT GUID * dimensionIDs, IN UINT count ) | Ruft die Bezeichner für die Rahmendimensionen dieses Image-Objekts ab. |
| GpStatus WINGDIPAPI GdipImageGetFrameCount(GpImage * image, GDIPCONST GUID * dimensionID, UINT * count) |
UINT Image::GetFrameCount( IN const GUID * dimensionID ) | Ruft die Anzahl der Frames in einer angegebenen Dimension dieses Image-Objekts ab. |
| GpStatus WINGDIPAPI GdipImageSelectActiveFrame(GpImage * image, GDIPCONST GUID * dimensionID, UINT frameIndex) |
Status Image::SelectActiveFrame( IN const GUID * dimensionID, IN UINT frameIndex ) | Wählt den Frame in diesem Bildobjekt aus, das durch eine Dimension und einen Index angegeben wird. |
| GpStatus WINGDIPAPI GdipImageRotateFlip(GpImage * image, RotateFlipType rfType) |
Status Image::RotateFlip( IN RotateFlipType rotateFlipType ) | Rotiert und flippt dieses Bild. |
| GpStatus WINGDIPAPI GdipGetImagePalette(GpImage * image, ColorPalette * palette, INT size) |
Status image::GetPalette( OUT ColorPalette * palette, IN INT size ) | Ruft die ColorPalette dieses Image-Objekts ab. |
| GpStatus WINGDIPAPI GdipSetImagePalette(GpImage * image, GDIPCONST ColorPalette * palette) |
Status Image::SetPalette( IN const ColorPalette * palette ) | Legt die Farbpalette dieses Bildobjekts fest. |
| GpStatus WINGDIPAPI GdipGetImagePaletteSize(GpImage * image, INT * size) |
INT Image::GetPaletteSize() | Ruft die Größe der Farbpalette dieses Bildobjekts in Bytes ab. |
| GpStatus WINGDIPAPI GdipGetPropertyCount(GpImage * image, UINT * numOfProperty) |
UINT Image::GetPropertyCount() | Ruft das Pixelformat dieses Bildobjekts ab. |
| GpStatus WINGDIPAPI GdipGetPropertyIdList(GpImage * image, UINT numOfProperty, PROPID * list) |
Status Image::GetPropertyIdList( IN UINT numOfProperty, OUT PROPID * list ) | Ruft eine Liste der Eigenschaftenbezeichner ab, die in den Metadaten dieses Image-Objekts verwendet werden. |
| GpStatus WINGDIPAPI GdipGetPropertyItemSize(GpImage * image, PROPID propId, UINT * size) |
UINT Image::GetPropertyItemSize( IN PROPID propId ) | Ruft die Größe eines angegebenen Eigenschaftselements dieses Image-Objekts in Bytes ab. |
| GpStatus WINGDIPAPI GdipGetPropertyItem(GpImage * image, PROPID propId,UINT propSize, PropertyItem * buffer) |
Status Image::GetPropertyItem( IN PROPID propId, IN UINT propSize, OUT PropertyItem * buffer ) | Ruft ein angegebenes Eigenschaftenelement (Metadatenelement) aus diesem Image-Objekt ab. |
| GpStatus WINGDIPAPI GdipGetPropertySize(GpImage * image, UINT * totalBufferSize, UINT * numProperties) |
Status Image::GetPropertySize( OUT UINT * totalBufferSize, OUT UINT * numProperties ) | Ruft die Gesamtgröße aller in diesem Image-Objekt gespeicherten Eigenschaftselemente in Bytes ab. Diese Methode ruft auch die Anzahl der Eigenschaftselemente ab, die in diesem Image-Objekt gespeichert sind. |
| GpStatus WINGDIPAPI GdipGetAllPropertyItems(GpImage * image, UINT totalBufferSize, UINT numProperties, PropertyItem * allItems) |
Status Image::GetAllPropertyItems( IN UINT totalBufferSize, IN UINT numProperties, OUT PropertyItem * allItems ) | Ruft alle Eigenschaftselemente (Metadaten) ab, die in diesem Image-Objekt gespeichert sind. |
| GpStatus WINGDIPAPI GdipRemovePropertyItem(GpImage * image, PROPID propId) |
Status Image::RemovePropertyItem( IN PROPID propId ) | Entfernt ein Eigenschaftselement (Teil der Metadaten) aus diesem Image-Objekt. |
| GpStatus WINGDIPAPI GdipSetPropertyItem(GpImage * image, GDIPCONST PropertyItem * item) |
Status Image::SetPropertyItem | Legt ein Eigenschaftselement (Metadatenelement) für dieses Image-Objekt fest. Wenn das Element bereits vorhanden ist, wird sein Inhalt aktualisiert. Andernfalls wird ein neues Element hinzugefügt. |
| GpStatus WINGDIPAPI GdipFindFirstImageItem(GpImage * image, ImageItemData * item) |
Status Image::FindFirstItem( IN ImageItemData * item ) | Ruft die Beschreibung und die Datengröße des ersten Metadatenelements in diesem Image-Objekt ab. |
| GpStatus WINGDIPAPI GdipFindNextImageItem(GpImage * image, ImageItemData * item) |
Status Image::FindNextItem( IN ImageItemData * item ) | Ruft die Beschreibung und die Datengröße des nächsten Metadatenelements in diesem Image-Objekt ab. Diese Methode wird zusammen mit der Image::FindFirstItem-Methode verwendet, um die Metadatenelemente aufzulisten, die in diesem Im Image Age-Objekt gespeichert sind. |
| GpStatus WINGDIPAPI GdipGetImageItemData(GpImage * image, ImageItemData * item) |
Status Image::GetItemData( IN ImageItemData * item ) | Ruft ein Metadatenteil aus diesem Image-Objekt ab. |
| GpStatus WINGDIPAPI GdipImageSetAbort(GpImage * pImage, GdiplusAbort * pIAbort) |
Status Image::SetAbort( GdiplusAbort * pIAbort ) | Legt das -Objekt fest, dessen Abort-Methode während eines zeitaufwändigen Renderingvorgangs regelmäßig aufgerufen wird. |
| GpStatus WINGDIPAPI GdipConvertToEmfPlus(const GpGraphics * refGraphics, GpMetafile * metafile, BOOL * conversionSuccess, EmfType emfType, const WCHAR * description, GpMetafile * * out _ metafile) |
Status metafile::ConvertToEmfPlus( const Graphics * refGraphics, BOOL * conversionSuccess, EmfType emfType, const WCHAR * description ) | Konvertiert dieses Metafile-Objekt in das EMF+-Format. |
| GpStatus WINGDIPAPI GdipConvertToEmfPlusToFile(const GpGraphics * refGraphics, GpMetafile * metafile, BOOL * conversionSuccess, const WCHAR * filename, EmfType emfType, const WCHAR * description, GpMetafile * * out _ metafile) |
Status metafile::ConvertToEmfPlus( const Graphics * refGraphics, const WCHAR * filename, BOOL * conversionSuccess, EmfType emfType, const WCHAR * description ) | Konvertiert dieses Metafile-Objekt in das EMF+-Format. |
| GpStatus WINGDIPAPI GdipConvertToEmfPlusToStream(const GpGraphics * refGraphics, GpMetafile * metafile, BOOL * conversionSuccess, IStream * stream, EmfType emfType, const WCHAR * description, GpMetafile * * out _ metafile) |
Status metafile::ConvertToEmfPlus( const Graphics * refGraphics, IStream * stream, BOOL * conversionSuccess, EmfType emfType, const WCHAR * description ) | Konvertiert dieses Metafile-Objekt in das EMF+-Format. |
| GpStatus WINGDIPAPI GdipImageForceValidation(GpImage * image) |
Wird nicht von Wrappermethoden aufgerufen. |
Diese Funktion erzwingt die Überprüfung des Bilds. |