SetBoundsRect-Funktion (wingdi.h)

Artikel
08/27/2023

Die SetBoundsRect-Funktion steuert die Akkumulation von umgebenden Rechteckinformationen für den angegebenen Gerätekontext. Das System kann ein begrenzungsgebundenes Rechteck für alle Zeichnungsvorgänge verwalten. Eine Anwendung kann dieses Rechteck untersuchen und festlegen. Die Zeichnungsgrenzen sind nützlich, um Bitmapcaches für ungültig zu erklären.

Syntax

UINT SetBoundsRect(
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext, für den begrenzungsbezogene Rechtecke gesammelt werden sollen.

[in] lprect

Ein Zeiger auf eine RECT-Struktur , die zum Festlegen des umgebenden Rechtecks verwendet wird. Rechteckdimensionen sind in logischen Koordinaten angegeben. Dieser Parameter kann NULL sein.

[in] flags

Gibt an, wie das neue Rechteck mit dem akkumulierten Rechteck kombiniert wird. Dieser Parameter kann einer der folgenden Werte sein.

Wert	Bedeutung
DCB_ACCUMULATE	Fügt das durch den lprcBounds-Parameter angegebene Rechteck dem umgebenden Rechteck hinzu (mithilfe eines Rechteck-Union-Vorgangs). Mit DCB_RESET und DCB_ACCUMULATE wird das umgebende Rechteck auf das durch den lprcBounds-Parameter angegebene Rechteck festgelegt.
DCB_DISABLE	Deaktiviert die Begrenzungsakkumulation.
DCB_ENABLE	Aktiviert die Begrenzungsakkumulation, die standardmäßig deaktiviert ist.
DCB_RESET	Löscht das umgebende Rechteck.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt der Rückgabewert den vorherigen Zustand des umgebenden Rechtecks an. Dieser Zustand kann eine Kombination der folgenden Werte sein.

Wert	Bedeutung
DCB_DISABLE	Die Begrenzungsakkumulation ist deaktiviert.
DCB_ENABLE	Die Begrenzungsakkumulation ist aktiviert. DCB_ENABLE und DCB_DISABLE schließen sich gegenseitig aus.
DCB_RESET	Das umgebende Rechteck ist leer.
DCB_SET	Das umgebende Rechteck ist nicht leer. DCB_SET und DCB_RESET schließen sich gegenseitig aus.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

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 bestimmen, ob das umgebende Rechteck leer ist, müssen ebenfalls 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


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 (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

GetBoundsRect

Mal- und Zeichenfunktionen

Übersicht über Das Malen und Zeichnen

RECT

Freigeben über