CDC::SelectClipRgn

Artigo
02/25/2013

Seleciona a região dada como a região recortada atual para o contexto de dispositivo.

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

Parâmetros

pRgn
Identifica a região seja selecionada.
- Para a primeira versão de essa função, se esse valor é NULO, toda a área cliente está selecionada e a saída é recortadas ainda para a janela.
- Para a segunda versão de essa função, este identificador pode ser NULO somente quando o modo de RGN_COPY é especificado.
nMode
Especifica a operação a ser executada.Deve ser um dos seguintes valores:
- RGN_AND a nova região de corte combina as áreas sobrepostos a região de corte da região atual e identificadas por pRgn.
- RGN_COPY a nova região de corte é uma cópia da região identificada por pRgn.Essa funcionalidade é é idêntica a primeira versão de SelectClipRgn.Se a região identificada por pRgn é NULO, a nova região de corte transformações a região de corte padrão (uma região nula).
- RGN_DIFF a nova região de corte combina as áreas da região de corte atual com essas áreas excluídos da região identificada por pRgn.
- RGN_OR a nova região de corte combina a região recortada atual e a região identificadas por pRgn.
- RGN_XOR a nova região de corte combina a região recortada atual e a região identificadas por pRgn mas exclui todas as áreas de sobreposição.

Valor de retorno

O tipo da região.Pode ser qualquer um dos seguintes valores:

A nova região de corte deCOMPLEXREGION tem sobrepostos bordas.
O contexto ou região de dispositivo deERRO não é válido.
A nova região de corte deNULLREGION está vazia.
A nova região de corte deSIMPLEREGION não tem nenhuma borda sobrepostos.

Comentários

Apenas uma cópia da região selecionada é usada.A própria região pode ser selecionada para qualquer número de outros contextos de dispositivo, ou pode ser excluída.

A função assume que as coordenadas para a região determinada são especificadas em unidades de dispositivo.Alguns dispositivos de impressão suportam saída de um texto em mais de alta resolução de saída gráficos para manter a precisão necessárias para expressar métricas de texto.Esses dispositivos relatam unidades de dispositivo em mais de alta resolução, isto é, em unidades de texto.Esses dispositivos tamanho em coordenadas de gráfico de modo que mapeiam relatado de várias unidades de dispositivo a apenas 1 unidade gráfica.Você sempre deve chamar a função de SelectClipRgn usando unidades de texto.

Aplicativos que devem levar a escala de objeto gráfico em GDI podem usar o escape de impressora de GETSCALINGFACTOR para determinar o fator de escala.Este fator de escala afeta o recorte.Se uma região é usada para recortar gráficos, GDI divide as coordenadas pelo fator de escala.Se a região é usada para recortar texto, GDI não faz nenhum ajuste de dimensionamento.Um fator de escala de 1 faz com que as coordenadas para ser divididas por 2; um fator de escala de 2 faz com que as coordenadas ser dividido por 4; e assim por diante.