Uso de contenedores gráficos anidados

GDI+ proporciona contenedores que puede usar para reemplazar o aumentar temporalmente parte del estado en un Graphics objeto . Cree un contenedor llamando al método BeginContainer de un objeto Graphics. Puede llamar BeginContainer repetidamente para formar contenedores anidados. Cada llamada a BeginContainer debe emparejarse con una llamada a EndContainer.

Transformaciones en contenedores anidados

En el ejemplo siguiente se crea un Graphics objeto y un contenedor dentro de ese Graphics objeto. La transformación mundial del Graphics objeto es una traducción de 100 unidades en la dirección x y 80 unidades en la dirección y. La transformación mundial del contenedor es una rotación de 30 grados. El código realiza la llamada DrawRectangle(pen, -60, -30, 120, 60) dos veces. La primera llamada a DrawRectangle está dentro del contenedor; es decir, la llamada se encuentra entre las llamadas a BeginContainer y EndContainer. La segunda llamada a DrawRectangle es después de la llamada a EndContainer.

Graphics graphics = e.Graphics;
Pen pen = new Pen(Color.Red);
GraphicsContainer graphicsContainer;
graphics.FillRectangle(Brushes.Black, 100, 80, 3, 3);

graphics.TranslateTransform(100, 80);

graphicsContainer = graphics.BeginContainer();
graphics.RotateTransform(30);
graphics.DrawRectangle(pen, -60, -30, 120, 60);
graphics.EndContainer(graphicsContainer);

graphics.DrawRectangle(pen, -60, -30, 120, 60);

Dim graphics As Graphics = e.Graphics
Dim pen As New Pen(Color.Red)
Dim graphicsContainer As GraphicsContainer
graphics.FillRectangle(Brushes.Black, 100, 80, 3, 3)

graphics.TranslateTransform(100, 80)

graphicsContainer = graphics.BeginContainer()
graphics.RotateTransform(30)
graphics.DrawRectangle(pen, -60, -30, 120, 60)
graphics.EndContainer(graphicsContainer)

graphics.DrawRectangle(pen, -60, -30, 120, 60)

En el código anterior, el rectángulo dibujado desde dentro del contenedor se transforma primero por la transformación mundial del contenedor (rotación) y, a continuación, por la transformación mundial del Graphics objeto (traducción). El rectángulo dibujado desde fuera del contenedor solo se transforma mediante la transformación del mundo del objeto Graphics (traducción). En la ilustración siguiente se muestran los dos rectángulos:

Recorte en contenedores anidados

En el ejemplo siguiente se muestra cómo los contenedores anidados controlan las regiones de recorte. El código crea un Graphics objeto y un contenedor dentro de ese Graphics objeto. La región de recorte del Graphics objeto es un rectángulo y la región de recorte del contenedor es una elipse. El código realiza dos llamadas al DrawLine método . La primera llamada a DrawLine está dentro del contenedor y la segunda llamada a DrawLine está fuera del contenedor (después de la llamada a EndContainer). La primera línea se recorta mediante la intersección de las dos regiones de recorte. La segunda línea solo es recortada por la región de recorte rectangular del objeto Graphics.

Graphics graphics = e.Graphics;
GraphicsContainer graphicsContainer;
Pen redPen = new Pen(Color.Red, 2);
Pen bluePen = new Pen(Color.Blue, 2);
SolidBrush aquaBrush = new SolidBrush(Color.FromArgb(255, 180, 255, 255));
SolidBrush greenBrush = new SolidBrush(Color.FromArgb(255, 150, 250, 130));

graphics.SetClip(new Rectangle(50, 65, 150, 120));
graphics.FillRectangle(aquaBrush, 50, 65, 150, 120);

graphicsContainer = graphics.BeginContainer();
// Create a path that consists of a single ellipse.
GraphicsPath path = new GraphicsPath();
path.AddEllipse(75, 50, 100, 150);

// Construct a region based on the path.
Region region = new Region(path);
graphics.FillRegion(greenBrush, region);

graphics.SetClip(region, CombineMode.Replace);
graphics.DrawLine(redPen, 50, 0, 350, 300);
graphics.EndContainer(graphicsContainer);

graphics.DrawLine(bluePen, 70, 0, 370, 300);

Dim graphics As Graphics = e.Graphics
Dim graphicsContainer As GraphicsContainer
Dim redPen As New Pen(Color.Red, 2)
Dim bluePen As New Pen(Color.Blue, 2)
Dim aquaBrush As New SolidBrush(Color.FromArgb(255, 180, 255, 255))
Dim greenBrush As New SolidBrush(Color.FromArgb(255, 150, 250, 130))

graphics.SetClip(New Rectangle(50, 65, 150, 120))
graphics.FillRectangle(aquaBrush, 50, 65, 150, 120)

graphicsContainer = graphics.BeginContainer()
' Create a path that consists of a single ellipse.
Dim path As New GraphicsPath()
path.AddEllipse(75, 50, 100, 150)

' Construct a region based on the path.
Dim [region] As New [Region](path)
graphics.FillRegion(greenBrush, [region])

graphics.SetClip([region], CombineMode.Replace)
graphics.DrawLine(redPen, 50, 0, 350, 300)
graphics.EndContainer(graphicsContainer)

graphics.DrawLine(bluePen, 70, 0, 370, 300)

En la ilustración siguiente se muestran las dos líneas recortadas:

Como se muestra en los dos ejemplos anteriores, las transformaciones y las regiones de recorte se acumulan en contenedores anidados. Si establece las transformaciones globales del contenedor y del objeto Graphics, ambas transformaciones se aplicarán a los elementos dibujados internamente desde el contenedor. La transformación del contenedor se aplicará primero y la transformación del Graphics objeto se aplicará en segundo lugar. Si establece las regiones de recorte del contenedor y del objeto Graphics, los elementos dibujados desde dentro del contenedor se recortarán mediante la intersección de las dos regiones de recorte.

Configuración de calidad en contenedores anidados

La configuración de calidad (SmoothingMode, TextRenderingHinty la similar) en contenedores anidados no son acumulativas; en su lugar, la configuración de calidad del contenedor reemplaza temporalmente la configuración de calidad de un Graphics objeto. Al crear un contenedor, la configuración de calidad de ese contenedor se establece en valores predeterminados. Por ejemplo, supongamos que tiene un objeto Graphics con un modo de suavizado AntiAlias. Al crear un contenedor, el modo de suavizado dentro del contenedor es el modo de suavizado predeterminado. Es libre de establecer el modo de suavizado del contenedor y los elementos dibujados desde dentro del contenedor se dibujarán según el modo establecido. Los elementos dibujados después de la llamada a EndContainer se dibujarán según el modo de suavizado (AntiAlias) que estaba en su lugar antes de la llamada a BeginContainer.

Varias capas de contenedores anidados

No está limitado a un solo contenedor en un objeto Graphics. Puede crear una secuencia de contenedores, cada uno anidado en el anterior, y puede especificar la transformación del mundo, la región de recorte y la configuración de calidad de cada uno de esos contenedores anidados. Si llama a un método de dibujo desde dentro del contenedor más interno, las transformaciones se aplicarán en orden, empezando por el contenedor más interno y terminando con el contenedor más externo. Los elementos dibujados desde dentro del contenedor más interno se recortarán mediante la intersección de todas las regiones de recorte.

En el ejemplo siguiente se crea un Graphics objeto y se establece su sugerencia de representación de texto en AntiAlias. El código crea dos contenedores, uno anidado dentro del otro. La sugerencia de representación de texto del contenedor externo se establece en SingleBitPerPixely la sugerencia de representación de texto del contenedor interno se establece en AntiAlias. El código dibuja tres cadenas: una del contenedor interno, otra del contenedor externo y otra del Graphics propio objeto.

Graphics graphics = e.Graphics;
GraphicsContainer innerContainer;
GraphicsContainer outerContainer;
SolidBrush brush = new SolidBrush(Color.Blue);
FontFamily fontFamily = new FontFamily("Times New Roman");
Font font = new Font(fontFamily, 36, FontStyle.Regular, GraphicsUnit.Pixel);

graphics.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAlias;

outerContainer = graphics.BeginContainer();

graphics.TextRenderingHint = System.Drawing.Text.TextRenderingHint.SingleBitPerPixel;

innerContainer = graphics.BeginContainer();
graphics.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAlias;
graphics.DrawString(
   "Inner Container",
   font,
   brush,
   new PointF(20, 10));
graphics.EndContainer(innerContainer);

graphics.DrawString(
   "Outer Container",
   font,
   brush,
   new PointF(20, 50));

graphics.EndContainer(outerContainer);

graphics.DrawString(
   "Graphics Object",
   font,
   brush,
   new PointF(20, 90));

Dim graphics As Graphics = e.Graphics
Dim innerContainer As GraphicsContainer
Dim outerContainer As GraphicsContainer
Dim brush As New SolidBrush(Color.Blue)
Dim fontFamily As New FontFamily("Times New Roman")
Dim font As New Font( _
   fontFamily, _
   36, _
   FontStyle.Regular, _
   GraphicsUnit.Pixel)

graphics.TextRenderingHint = _
System.Drawing.Text.TextRenderingHint.AntiAlias

outerContainer = graphics.BeginContainer()

graphics.TextRenderingHint = _
    System.Drawing.Text.TextRenderingHint.SingleBitPerPixel

innerContainer = graphics.BeginContainer()
graphics.TextRenderingHint = _
    System.Drawing.Text.TextRenderingHint.AntiAlias
graphics.DrawString( _
   "Inner Container", _
   font, _
   brush, _
   New PointF(20, 10))
graphics.EndContainer(innerContainer)

graphics.DrawString("Outer Container", font, brush, New PointF(20, 50))

graphics.EndContainer(outerContainer)

graphics.DrawString("Graphics Object", font, brush, New PointF(20, 90))

En la ilustración siguiente se muestran las tres cadenas. Las cadenas obtenidas del contenedor interno y del objeto Graphics se suavizan mediante antialiasing. La cadena dibujada desde el contenedor externo no se suaviza mediante antialiasing porque la propiedad TextRenderingHint está establecida en SingleBitPerPixel.

Consulte también

• Graphics
• Administración del estado de un objeto gráfico