Caminhos de clipe

Como uma região de recorte, um caminho de recorte é 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 recorte é sempre criado por um aplicativo e é usado para recorte em uma ou mais formas irregulares. Por exemplo, um aplicativo pode usar as linhas e curvas que formam os contornos dos 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 da GDI (interface de dispositivo gráfico) 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ção SelectClipPath , identificando um contexto de dispositivo e especificando um modo de uso. O modo de uso determina como o sistema combina o novo caminho de clipe com a região de recorte original do contexto do dispositivo. A tabela a seguir descreve os modos de uso.

Mode Descrição
RGN_AND O caminho de 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 de clipe inclui a região de recorte do contexto do dispositivo com todas as partes interseccionais do caminho atual excluídas.
RGN_OR O caminho de clipe inclui a união (áreas combinadas) da região de recorte do contexto do dispositivo e o caminho atual.
RGN_XOR O caminho de clipe inclui a união da região de recorte do contexto do dispositivo e o caminho atual, mas exclui a interseção.