CDC::SelectClipRgn
Selecciona la región determinada como zona de recorte actual para el contexto del dispositivo.
int SelectClipRgn(
CRgn* pRgn
);
int SelectClipRgn(
CRgn* pRgn,
int nMode
);
Parámetros
pRgn
Identifica la región para seleccionar.Para la primera versión de esta función, si este valor es NULL, el área cliente completa es seleccionado y todavía se recortan a resultados en la.
Para la segunda versión de esta función, este identificador puede ser NULL sólo cuando se especifica el modo de RGN_COPY .
nMode
Especifica la operación que se va a realizar. Debe ser uno de los siguientes valores:La nueva región de recorte deRGN_AND The combina las áreas que se superponen de la zona de recorte actual y el área identificadas por pRgn.
La nueva región de recorte deRGN_COPY The es una copia de la región identificada por pRgn. Ésta es la funcionalidad es idéntica a la primera versión de SelectClipRgn. Si la región identificada por pRgn es NULL, la nueva zona de recorte se convierte en la zona de recorte predeterminada (una región NULL).
La nueva región de recorte deRGN_DIFF The combina las áreas de la región de recorte actual con esas áreas excluidas de región identificada por pRgn.
La nueva región de recorte deRGN_OR The combina la zona de recorte actual y la región identificadas por pRgn.
La nueva región de recorte deRGN_XOR The combina la zona de recorte actual y la región identificadas por pRgn pero excluye cualquier área que se superpone.
Valor devuelto
El tipo de área. Puede ser cualquiera de los valores siguientes:
La zona de recorte deCOMPLEXREGION Nuevo tiene superponer los bordes.
El contexto o la región del dispositivo deERROR no es válida.
La zona de recorte deNULLREGION New está vacía.
La zona de recorte deSIMPLEREGION Nuevo no tiene borde que se superpone.
Comentarios
Sólo una copia de la región seleccionada se utiliza. La región propio puede seleccionarse para cualquier número de otros contextos de dispositivo, o se puede eliminar.
La función se supone que las coordenadas de la región determinada se especifique en unidades. Algún resultado de texto de la compatibilidad con dispositivos de impresora en un una resolución mayor de que los gráficos generados para conservar la precisión para expresar métricas de texto. Estos dispositivos señalan unidades en el una resolución mayor de, es decir, en unidades de texto. Estos dispositivos a continuación ajusta las coordenadas de gráficos de modo que varias unidades designadas asignados a solo 1 unidad gráfica. Siempre se debería llamar a la función de SelectClipRgn utilizando unidades de texto.
Las aplicaciones que deben tomar el ajuste de escala de los objetos gráficos de GDI pueden utilizar el escape de impresora de GETSCALINGFACTOR para determinar el factor de escala. Este factor de escala afecta al recorte. Si una región se utiliza para los gráficos de recorte, GDI divide las coordenadas según el factor de escala. Si la región se utiliza el texto de recorte, GDI no crea ningún ajuste de escala. Un factor de escala de 1 hace que las coordenadas que se dividirán por 2; un factor de escala de 2 hace que las coordenadas de dividir por 4; etc.
Requisitos
encabezado: afxwin.h