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.