Partilhar via


CDC::SelectClipRgn

Seleciona determinada região sistema autônomo a região de recorte corrente para o contexto de dispositivo.

int SelectClipRgn(
   CRgn* pRgn 
);
int SelectClipRgn(
   CRgn* pRgn,
   int nMode 
);

Parâmetros

  • pRgn
    Identifica a região a ser selecionado.

    • Para a primeira versão dessa função, se esse valor for NULO, toda a área de cliente está selecionada e saída ainda será recortada para a janela.

    • Para a segunda versão dessa função, este identificador pode ser NULO somente quando o RGN_COPY modo for especificado.

  • nMode
    Especifica a operação a ser executada.Ele deve ser um dos seguintes valores:

    • RGN_AND   A nova região de recorte combina as áreas sobrepostas da corrente região de recorte e região identificada pelo pRgn.

    • RGN_COPY   A nova região de recorte é uma cópia da região identificada pelo pRgn. Essa é uma funcionalidade é idêntica à primeira versão do SelectClipRgn. Se a região identificada pelo pRgn é NULO, a nova região de recorte torna-se o padrão (região nulo) região de recorte.

    • RGN_DIFF   A nova região de recorte combina as áreas da corrente região de recorte com essas áreas excluídas da região identificada pelo pRgn.

    • RGN_OR   A nova região de recorte combina a corrente região de recorte e região identificada pelo pRgn.

    • RGN_XOR   A nova região de recorte combina a corrente região de recorte e região identificada pelo pRgn mas exclui todas as áreas sobrepostas.

Valor de retorno

Tipo da região.Ele pode ser qualquer um dos seguintes valores:

  • COMPLEXREGION   Nova região de recorte tem sobrepostas bordas.

  • ERRO   Contexto de dispositivo ou a região inválido.

  • NULLREGION   Nova região de recorte está vazio.

  • SIMPLEREGION   Nova região de recorte não possui sobrepostas bordas.

Comentários

Somente uma cópia da região selecionada é usada.A região de si mesmo pode ser selecionada para qualquer número de outros contextos de dispositivo ou pode ser excluído.

A função pressupõe que as coordenadas para determinada região estão especificadas nas unidades do dispositivo.Alguns dispositivos de impressora oferecem suporte a saída de texto com uma resolução mais alta que a saída de elementos gráficos a fim de manter a precisão necessária para expressar métricas de texto.Esses dispositivos relatar unidades do dispositivo com resolução mais alta, ou seja, em unidades de texto.Esses dispositivos, em seguida, dimensione coordenadas para elementos gráficos para que várias reportadas MAP de unidades do dispositivo à unidade gráfica apenas 1.Você deve sempre telefonar o SelectClipRgn função usando unidades de texto.

Aplicativos que devem tomar o dimensionamento de objetos gráficos a GDI podem usar o GETSCALINGFACTOR escape de impressora para determinar o fator de escala.Esse fator de escala afeta o recorte.Se uma região é usado para clipe elementos gráficos, GDI divide as coordenadas pelo fator de escala.Se a região é usada para recortar texto, GDI não torna nenhum ajuste de escala.Um fator de escala de 1 faz com que as coordenadas seja dividido por 2; um fator de escala de 2 faz com que as coordenadas ser dividida por 4; e assim por diante.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDC

Gráfico de hierarquia

CDC::GetClipBox

CDC::Escape

Classe CRgn

SelectClipRgn

Outros recursos

Membros do CDC