Share via

GetBoundsRect-Funktion (wingdi.h)

  • Artikel

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
DCB_RESET
 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

Weitere Informationen

Mal- und Zeichenfunktionen

Übersicht über Malerei und Zeichnung

SetBoundsRect