Caminhos de clipe

Como uma região de recorte, um caminho de clipe é outro objeto gráfico que um aplicativo pode selecionar em um contexto de dispositivo. Ao contrário de uma região de recorte, um caminho de clipe é sempre criado por um aplicativo e é usado para recortar para uma ou mais formas irregulares. Por exemplo, um aplicativo pode usar as linhas e curvas que formam os contornos de caracteres em uma cadeia de caracteres de texto para definir um caminho de clipe.

Para criar um caminho de clipe, primeiro é necessário criar um caminho que descreva a forma irregular necessária. Os caminhos são criados chamando as funções de desenho GDI (graphics device interface) apropriadas depois de chamar a função BeginPath e antes de chamar a função EndPath. Essa coleção de funções é chamada de colchete de caminho. Para obter mais informações sobre caminhos e colchetes de caminho, consulte Caminhos.

Depois que o caminho é criado, ele pode ser convertido em um caminho de clipe chamando a funçãoSelectClipPath, identificando um contexto de dispositivo e especificando um modo de uso. O modo de uso determina como o sistema combina o novo caminho do clipe com a região de recorte original do contexto do dispositivo. A tabela a seguir descreve os modos de uso.

Modo	Descrição
RGN_AND	O caminho do clipe inclui a interseção (áreas sobrepostas) da região de recorte do contexto do dispositivo e o caminho atual.
RGN_COPY	O caminho do clipe é o caminho atual.
RGN_DIFF	O caminho do clipe inclui a região de recorte do contexto do dispositivo com todas as partes interseccionadas do caminho atual excluídas.
RGN_OR	O caminho do clipe inclui a união (áreas combinadas) da região de recorte do contexto do dispositivo e o caminho atual.
RGN_XOR	O caminho do clipe inclui a união da região de recorte do contexto do dispositivo e o caminho atual, mas exclui a interseção.