Funzione SelectClipPath (wingdi.h)

  • Articolo

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

Vedi anche

BeginPath

Funzioni di ritaglio

Panoramica del ritaglio

EndPath