Freigeben über


Graphics::D rawImage(Image*,RectF*,Matrix*,Effect*,ImageAttributes*,Unit)-Methode (gdiplusgraphics.h)

Die -Methode zeichnet einen Teil eines Bilds nach dem Anwenden eines angegebenen Effekts.

Syntax

Status DrawImage(
  [in] Image           *image,
  [in] RectF           *sourceRect,
  [in] Matrix          *xForm,
  [in] Effect          *effect,
  [in] ImageAttributes *imageAttributes,
  [in] Unit            srcUnit
);

Parameter

[in] image

Typ: Image*

Zeiger auf ein Image-Objekt , das das zu zeichnende Bild angibt.

[in] sourceRect

Typ: RectF*

Zeiger auf ein RectF-Objekt , das den gezeichneten Teil des Bilds angibt.

[in] xForm

Typ: Matrix*

Zeiger auf ein Matrix-Objekt , das das Parallelogramm angibt, in dem der Bildteil gerendert wird. Das Zielparallelogramm wird berechnet, indem die in der Matrix gespeicherte affine Transformation auf das Quellrechteck angewendet wird.

[in] effect

Typ: Effekt*

Zeiger auf eine instance eines Nachfolgers der Effect-Klasse. Der Nachfolger gibt einen Effekt oder eine Anpassung (z. B. eine Kontraständerung) an, die vor dem Rendern auf das Bild angewendet wird. Das Bild wird durch den Effekt nicht dauerhaft geändert.

[in] imageAttributes

Typ: ImageAttributes*

Zeiger auf ein ImageAttributes-Objekt , das Farbanpassungen angibt, die angewendet werden sollen, wenn das Bild gerendert wird. Kann NULL sein.

[in] srcUnit

Typ: Einheit*

Element der Unit-Enumeration , das die Maßeinheit für das Quellrechteck angibt.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile gdiplusgraphics.h (include Gdiplus.h)
Bibliothek Gdiplus.lib
DLL Gdiplus.dll

Weitere Informationen

Zeichnen, Positionieren und Klonen von Bildern

Grafiken

Image

Laden und Anzeigen von Bitmaps