GetBoundsRect-Funktion (wingdi.h)
Die GetBoundsRect-Funktion ruft das aktuell akkumulierte begrenzungsbezogene Rechteck für einen angegebenen Gerätekontext ab.
Das System verwaltet ein akkumuliertes begrenzungsfähiges Rechteck für jede Anwendung. Eine Anwendung kann dieses Rechteck abrufen und festlegen.
Syntax
UINT GetBoundsRect(
[in] HDC hdc,
[out] LPRECT lprect,
[in] UINT flags
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext, dessen begrenzungsbezogenes Rechteck von der Funktion zurückgegeben wird.
[out] lprect
Ein Zeiger auf die RECT-Struktur , die das aktuell umgebende Rechteck empfängt. Das Rechteck der Anwendung wird in logischen Koordinaten zurückgegeben, und das umgebende Rechteck wird in Bildschirmkoordinaten zurückgegeben.
[in] flags
Gibt an, wie sich die GetBoundsRect-Funktion verhält. Dieser Parameter kann der folgende Wert sein.
| Wert | Bedeutung |
|---|---|
|
Löscht das umgebende Rechteck, nachdem es zurückgegeben wurde. Wenn dieses Flag nicht festgelegt ist, wird das umgebende Rechteck nicht gelöscht. |
Rückgabewert
Der Rückgabewert gibt den Zustand des akkumulierten begrenzungsenden Rechtecks an. Es kann sich um einen der folgenden Werte handeln.
| Wert | Bedeutung |
|---|---|
| 0 | Ein Fehler ist aufgetreten. Das angegebene Gerätekontexthandle ist ungültig. |
| DCB_DISABLE | Die Begrenzungsakkumulation ist deaktiviert. |
| DCB_ENABLE | Die Begrenzungsakkumulation ist aktiviert. |
| DCB_RESET | Das umgebende Rechteck ist leer. |
| DCB_SET | Das umgebende Rechteck ist nicht leer. |
Hinweise
Der DCB_SET Wert ist eine Kombination aus den Bitwerten DCB_ACCUMULATE und DCB_RESET. Anwendungen, die das DCB_RESET Bit überprüfen, um zu ermitteln, ob das umgebende Rechteck leer ist, müssen auch das DCB_ACCUMULATE Bit überprüfen. Das umgebende Rechteck ist nur leer, wenn das DCB_RESET Bit 1 und das DCB_ACCUMULATE Bit 0 ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (einschließlich Windows.h) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |