Come un'area di ritaglio, un percorso clip è un altro oggetto grafico che un'applicazione può selezionare in un contesto del dispositivo. A differenza di un'area di ritaglio, un percorso clip viene sempre creato da un'applicazione e viene usato per ritagliare una o più forme irregolari. Ad esempio, un'applicazione può usare le linee e le curve che formano i contorni di caratteri in una stringa di testo per definire un percorso clip.
Per creare un percorso clip, è prima necessario creare un percorso che descrive la forma irregolare necessaria. I percorsi vengono creati chiamando le funzioni di disegno GDI (Graphics Device Interface) appropriate dopo aver chiamato la funzione BeginPath e prima di chiamare la funzione EndPath . Questa raccolta di funzioni viene chiamata parentesi percorso. Per altre informazioni sui percorsi e sulle parentesi di percorso, vedere Percorsi.
Dopo aver creato il percorso, può essere convertito in un percorso clip chiamando la funzione SelectClipPath , identificando un contesto del dispositivo e specificando una modalità di utilizzo. La modalità di utilizzo determina come il sistema combina il nuovo percorso clip con l'area di ritaglio originale del contesto del dispositivo. Nella tabella seguente vengono descritte le modalità di utilizzo.
Mode
Descrizione
RGN_AND
Il percorso clip include l'intersezione (aree sovrapposte) dell'area di ritaglio del contesto del dispositivo e il percorso corrente.
RGN_COPY
Il percorso clip è il percorso corrente.
RGN_DIFF
Il percorso clip include l'area di ritaglio del contesto del dispositivo con qualsiasi parte intersecante del percorso corrente escluso.
RGN_OR
Il percorso clip include l'unione (aree combinate) dell'area di ritaglio del contesto del dispositivo e il percorso corrente.
RGN_XOR
Il percorso clip include l'unione dell'area di ritaglio del contesto del dispositivo e il percorso corrente, ma esclude l'intersezione.
Questa sezione contiene codice di esempio che illustra come generare un percorso di ritaglio costituito da una stringa di caratteri. L'esempio crea un tipo di carattere logico e lo usa per disegnare una stringa all'interno di un percorso di ritaglio, quindi riempie il percorso disegnando linee orizzontali e verticali.
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.
Il ritaglio è il processo di limitazione dell'output a un'area o a un percorso all'interno dell'area client di una finestra dell'applicazione. Le sezioni seguenti illustrano il ritaglio.