Freigeben über


SetBoundsRect-Funktion (wingdi.h)

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