Regiones de recorte

Una región de recorte es uno de los objetos gráficos que una aplicación puede seleccionar en un contexto de dispositivo (DC). Normalmente es rectangular. Algunos contextos de dispositivo proporcionan una región de recorte predefinida o predeterminada, mientras que otras no. Por ejemplo, si obtiene un identificador de contexto de dispositivo de la función BeginPaint , el controlador de dominio contiene una región de recorte rectangular predefinida que corresponde al rectángulo no válido que requiere volver a pintar. Sin embargo, cuando se obtiene un identificador de contexto de dispositivo llamando a la función GetDC con un parámetro hWndNULL o llamando a la función CreateDC, el controlador de dominio no contiene una región de recorte predeterminada. Para obtener más información sobre los contextos de dispositivo devueltos por la función BeginPaint , vea Painting and Drawing . Para obtener más información sobre los contextos de dispositivo devueltos por las funciones CreateDC y GetDC , consulte Contextos de dispositivo.

Las aplicaciones pueden realizar diversas operaciones en regiones de recorte. Algunas de estas operaciones requieren un identificador que identifique la región y otras no. Por ejemplo, una aplicación puede realizar las siguientes operaciones directamente en la región de recorte de un contexto de dispositivo.

• Determine si la salida de gráficos aparece dentro de los bordes de la región pasando coordenadas de la línea, arco, mapa de bits, texto o forma rellena correspondiente a la función PtVisible .
• Determine si parte del área de cliente interseca una región mediante una llamada a la función RectVisible .
• Mueva la región existente por un desplazamiento especificado llamando a la función OffsetClipRgn .
• Excluya una parte rectangular del área cliente de la región de recorte actual llamando a la función ExcludeClipRect .
• Combine una parte rectangular del área cliente con la región de recorte actual llamando a la función IntersectClipRect .

Después de obtener un identificador que identifique la región de recorte, una aplicación puede realizar cualquier operación que sea común con regiones, como:

• Combinando una copia de la región de recorte actual con una segunda región mediante una llamada a la función CombineRgn .
• Compare una copia de la región de recorte actual en una segunda región mediante una llamada a la función EqualRgn .
• Determine si un punto se encuentra dentro del interior de una copia de la región de recorte actual mediante una llamada a la función PtInRegion .