Funzione ExtSelectClipRgn (wingdi.h)
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 |
|---|---|
|
La nuova area di ritaglio combina le aree sovrapposte dell'area di ritaglio corrente e l'area identificata da hrgn. |
|
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). |
|
La nuova area di ritaglio combina le aree dell'area di ritaglio corrente con quelle aree escluse dall'area identificata da hrgn. |
|
La nuova area di ritaglio combina l'area di ritaglio corrente e l'area identificata da hrgn. |
|
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 |
|---|---|
|
L'area è vuota. |
|
L'area è un singolo rettangolo. |
|
L'area è più di un rettangolo. |
|
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 |