Graphics (Clase)

La clase Graphics proporciona métodos para dibujar objetos en el dispositivo de pantalla. Graphics se asocia a un determinado contexto de dispositivo.

Se puede obtener un objeto Graphics llamando al método Control.CreateGraphics en un objeto que herede de System.Windows.Forms.Control, o controlando el evento Control.Paint de un control y obteniendo acceso a la propiedad Graphics de la clase System.Windows.Forms.PaintEventArgs. También puede crear un objeto Graphics a partir de una imagen utilizando el método FromImage. Para obtener más información acerca de la creación de un objeto Graphics, vea Cómo: Crear objetos Graphics para dibujar.

Puede dibujar muchas formas y líneas diferentes utilizando un objeto Graphics. Para obtener más información sobre cómo dibujar líneas y formas, vea el método DrawGraphicalElement concreto para la línea o la forma desea dibujar. Estos métodos incluyen DrawLine, DrawArc, DrawClosedCurve, DrawPolygon y DrawRectangle. Para obtener más información sobre cómo dibujar líneas y formas, vea Utilizar lápiz para dibujar líneas y formas y Utilizar un pincel para rellenar formas.

También puede dibujar imágenes e iconos utilizando los métodos DrawImage y DrawIcon, respectivamente. Para realizar una transferencia de bloque de bits de los datos de color de la pantalla a la superficie de dibujo del objeto Graphics, vea CopyFromScreen. Para obtener más información sobre cómo dibujar imágenes con un objeto Graphics, vea Trabajar con imágenes, mapas de bits, iconos y metarchivos.

Además, puede manipular el sistema de coordenadas usado por el objeto Graphics. Para obtener más información sobre el sistema de coordenadas y cómo manipularlo, vea Sistemas de coordenadas y transformaciones.

El siguiente ejemplo de código está pensado para usarse con formularios Windows Forms y requiere un objeto PaintEventArgs. El objeto PaintEventArgs se denomina e y es un parámetro del controlador de eventos Paint. El código realiza las acciones siguientes:

• Crea una imagen a partir de un archivo JPEG. El archivo se denomina SampImag.jpg y se ubica en la carpeta del ejemplo.

• Crea un punto en el cual se dibujará la esquina superior izquierda de la imagen.

• Dibuja la imagen sin ajustar a escala en la pantalla utilizando un objeto Graphics.

private void DrawImagePointF(PaintEventArgs e)
{

    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");

    // Create point for upper-left corner of image.
    PointF ulCorner = new PointF(100.0F, 100.0F);

    // Draw image to screen.
    e.Graphics.DrawImage(newImage, ulCorner);
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia

Otros recursos