ID2D1DeviceContext::GetImageWorldBounds-Methode (d2d1_1.h)

  • Artikel

Ruft die Grenzen eines Bilds ab, wobei die Welttransformation des Kontexts angewendet wird.

Syntax

HRESULT GetImageWorldBounds(
  [in]  ID2D1Image  *image,
  [out] D2D1_RECT_F *worldBounds
);

Parameter

[in] image

Typ: ID2D1Image*

Das Bild, dessen Begrenzungen berechnet werden.

[out] worldBounds

Typ: D2D1_RECT_F[1]

Wenn diese Methode zurückgibt, enthält einen Zeiger auf die Grenzen des Bilds in geräteunabhängigen Pixeln (Device Independent Pixels, DIPs).

Rückgabewert

Typ: HRESULT

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

HRESULT BESCHREIBUNG
S_OK Kein Fehler ist aufgetreten.
E_OUTOFMEMORY Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen.
E_INVALIDARG Ein ungültiger Parameter wurde an die zurückgebende Funktion übergeben.

Hinweise

Die Bildgrenzen spiegeln den aktuellen DPI-Wert, den Einheitenmodus und die Welttransformation des Kontexts wider. Um Grenzen abzurufen, die die Welttransformation nicht enthalten, verwenden Sie ID2D1DeviceContext::GetImageLocalBounds.

Die zurückgegebenen Begrenzungen geben an, welche Pixel durch aufrufen von DrawImage mit demselben Bild und einem Zieloffset von (0,0) betroffen wären. Sie spiegeln nicht das aktuelle Cliprechteck wider, das im Gerätekontext festgelegt ist, oder den Umfang des aktuellen Zielbilds des Kontexts.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1_1.h
DLL D2d1.dll

Weitere Informationen

D2D1_RECT_F

ID2D1DeviceContext

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::GetImageLocalBounds

ID2D1Image