ID2D1DeviceContext::GetImageWorldBounds-Methode (d2d1_1.h)
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
ID2D1DeviceContext::CreateBitmap