Funzione ExtSelectClipRgn (wingdi.h)

Articolo
03/13/2024

La funzione ExtSelectClipRgn combina l'area specificata con l'area di ritaglio corrente usando la modalità specificata.

Sintassi

int ExtSelectClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] int  mode
);

Parametri

[in] hdc

Handle nel contesto del dispositivo.

[in] hrgn

Handle per l'area da selezionare. Questo handle non deve essere NULL a meno che non sia specificata la modalità RGN_COPY.

[in] mode

L'operazione da eseguire. Deve essere uno dei valori seguenti.

Valore	Significato
RGN_AND	La nuova area di ritaglio combina le aree sovrapposte dell'area di ritaglio corrente e l'area identificata da hrgn.
RGN_COPY	La nuova area di ritaglio è una copia dell'area identificata da hrgn. Questo è identico a SelectClipRgn. Se l'area identificata da hrgn è NULL, la nuova area di ritaglio è l'area di ritaglio predefinita (l'area di ritaglio predefinita è un'area Null).
RGN_DIFF	La nuova area di ritaglio combina le aree dell'area di ritaglio corrente con quelle aree escluse dall'area identificata da hrgn.
RGN_OR	La nuova area di ritaglio combina l'area di ritaglio corrente e l'area identificata da hrgn.
RGN_XOR	La nuova area di ritaglio combina l'area di ritaglio corrente e l'area identificata da hrgn , ma esclude eventuali aree sovrapposte.

Valore restituito

Il valore restituito specifica la complessità della nuova area di ritaglio; può essere uno dei valori seguenti.

Codice restituito	Descrizione
NULLREGION	L'area è vuota.
SIMPLEREGION	L'area è un singolo rettangolo.
COMPLEXREGION	L'area è più di un rettangolo.
ERROR	Si è verificato un errore.

Commenti

Se si verifica un errore quando questa funzione viene chiamata, l'area di ritaglio precedente per il contesto del dispositivo specificato non è influenzata.

La funzione ExtSelectClipRgn presuppone che le coordinate per l'area specificata siano specificate nelle unità dispositivo.

Viene usata solo una copia dell'area identificata dal parametro hrgn . L'area stessa può essere riutilizzata dopo questa chiamata o può essere eliminata.

Requisiti

Requisito	Valore
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

Funzioni di ritaglio

Panoramica del ritaglio

SelezionareClipRgn

Condividi tramite