ID2D1RenderTarget::D rawBitmap(ID2D1Bitmap*,constD2D1_RECT_F*,FLOAT,D2D1_BITMAP_INTERPOLATION_MODE,constD2D1_RECT_F*)-Methode (d2d1.h)

Zeichnet die angegebene Bitmap nach der Skalierung auf die Größe des angegebenen Rechtecks.

Syntax

void DrawBitmap(
  [in]           ID2D1Bitmap                    *bitmap,
  [in, optional] const D2D1_RECT_F              *destinationRectangle,
                 FLOAT                          opacity,
                 D2D1_BITMAP_INTERPOLATION_MODE interpolationMode,
  [in, optional] const D2D1_RECT_F              *sourceRectangle
);

Parameter

[in] bitmap

Typ: ID2D1Bitmap*

Die zu rendernden Bitmaps.

[in, optional] destinationRectangle

Typ: const D2D1_RECT_F*

Größe und Position des Bereichs, in den die Bitmap gezeichnet wird, in geräteunabhängigen Pixeln im Koordinatenbereich des Renderziels; NULL , um den ausgewählten Teil der Bitmap am Ursprung des Renderziels zu zeichnen. Wenn das Rechteck angegeben, aber nicht ordnungsgemäß sortiert ist, wird nichts gezeichnet, aber das Renderziel wechselt nicht in einen Fehlerzustand.

opacity

Typ: FLOAT

Ein Wert zwischen 0,0f und einschließlich 1,0f, der einen Deckkraftwert angibt, der auf die Bitmap angewendet werden soll; Dieser Wert wird mit den Alphawerten des Bitmapinhalts multipliziert. Der Standardwert ist 1,0f.

interpolationMode

Typ: D2D1_BITMAP_INTERPOLATION_MODE

Der Interpolationsmodus, der verwendet werden soll, wenn die Bitmap durch den Zeichnungsvorgang skaliert oder gedreht wird. Der Standardwert ist D2D1_BITMAP_INTERPOLATION_MODE_LINEAR.

[in, optional] sourceRectangle

Typ: const D2D1_RECT_F*

Größe und Position des zu zeichnenden Bitmapbereichs in geräteunabhängigen Pixeln im Koordinatenbereich der Bitmap; NULL , um die gesamte Bitmap zu zeichnen.

Rückgabewert

Keine

Bemerkungen

Diese Methode gibt keinen Fehlercode zurück, wenn sie fehlschlägt. Überprüfen Sie das Ergebnis, das von den Methoden ID2D1RenderTarget::EndDraw oder ID2D1RenderTarget::Flush zurückgegeben wird, um festzustellen, ob bei einem Zeichnungsvorgang (z. B. DrawBitmap) ein Fehler aufgetreten ist.

Beispiele

Ein Beispiel finden Sie unter Zeichnen einer Bitmap. Ein Beispiel zum Laden einer Bitmap aus einer Ressource oder datei finden Sie unter Laden einer Bitmap aus einer Ressource und Laden einer Bitmap aus einer Datei.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1.h
Bibliothek	D2d1.lib
DLL	D2d1.dll

Weitere Informationen

Zeichnen einer Bitmap

Laden einer Bitmap aus einer Datei

Laden einer Bitmap aus einer Ressource

ID2D1RenderTarget