Funzione SelectClipPath (wingdi.h)

Articolo
03/09/2024

La funzione SelectClipPath seleziona il percorso corrente come area di ritaglio per un contesto di dispositivo, combinando la nuova area con qualsiasi area di ritaglio esistente usando la modalità specificata.

Sintassi

BOOL SelectClipPath(
  [in] HDC hdc,
  [in] int mode
);

Parametri

[in] hdc

Handle per il contesto del dispositivo del percorso.

[in] mode

Modalità di utilizzo del percorso. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
RGN_AND	La nuova area di ritaglio include l'intersezione (aree sovrapposte) dell'area di ritaglio corrente e il percorso corrente.
RGN_COPY	La nuova area di ritaglio è il percorso corrente.
RGN_DIFF	La nuova area di ritaglio include le aree dell'area di ritaglio corrente con quelle del percorso corrente escluse.
RGN_OR	La nuova area di ritaglio include l'unione (aree combinate) dell'area di ritaglio corrente e il percorso corrente.
RGN_XOR	La nuova area di ritaglio include l'unione dell'area di ritaglio corrente e del percorso corrente, ma senza le aree sovrapposte.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

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

Commenti

Il contesto del dispositivo identificato dal parametro hdc deve contenere un percorso chiuso.

Esempio

Per un esempio, vedere Uso del ritaglio.

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