Funzione SetBoundsRect (wingdi.h)

Articolo
03/08/2023

La funzione SetBoundsRect controlla l'accumulo di informazioni sul rettangolo di delimitazione per il contesto di dispositivo specificato. Il sistema può mantenere un rettangolo di delimitazione per tutte le operazioni di disegno. Un'applicazione può esaminare e impostare questo rettangolo. I limiti del disegno sono utili per invalidare le cache bitmap.

Sintassi

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

Parametri

[in] hdc

Handle per il contesto del dispositivo per il quale accumulare rettangoli di delimitazione.

[in] lprect

Puntatore a una struttura RECT utilizzata per impostare il rettangolo di delimitazione. Le dimensioni del rettangolo sono in coordinate logiche. Questo parametro può essere NULL.

[in] flags

Specifica la modalità di combinazione del nuovo rettangolo con il rettangolo accumulato. Questo parametro può essere uno dei valori seguenti.

Valore	Significato
DCB_ACCUMULATE	Aggiunge il rettangolo specificato dal parametro lprcBounds al rettangolo di delimitazione (utilizzando un'operazione di unione rettangolo). Usando sia DCB_RESET che DCB_ACCUMULATE imposta il rettangolo di delimitazione sul rettangolo specificato dal parametro lprcBounds .
DCB_DISABLE	Disattiva l'accumulo di limiti.
DCB_ENABLE	Attiva l'accumulo di limiti, che è disabilitato per impostazione predefinita.
DCB_RESET	Cancella il rettangolo di delimitazione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito specifica lo stato precedente del rettangolo di delimitazione. Questo stato può essere una combinazione dei valori seguenti.

Valore	Significato
DCB_DISABLE	L'accumulo di limiti è disattivato.
DCB_ENABLE	L'accumulo di limiti è acceso. DCB_ENABLE e DCB_DISABLE si escludono a vicenda.
DCB_RESET	Il rettangolo di delimitazione è vuoto.
DCB_SET	Il rettangolo di delimitazione non è vuoto. DCB_SET e DCB_RESET si escludono a vicenda.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Il valore DCB_SET è una combinazione dei valori di bit DCB_ACCUMULATE e DCB_RESET. Le applicazioni che controllano il bit DCB_RESET per determinare se il rettangolo di delimitazione è vuoto deve controllare anche il bit DCB_ACCUMULATE. Il rettangolo di delimitazione è vuoto solo se il bit DCB_RESET è 1 e il bit DCB_ACCUMULATE è 0.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll

Vedi anche

GetBoundsRect

Funzioni di disegno e disegno

Panoramica di disegno e disegno

RECT

Share via