Actualización: noviembre 2007
Encapsula una superficie de dibujo de GDI+. No se puede heredar esta clase.
Espacio de nombres:
System.Drawing
Ensamblado:
System.Drawing (en System.Drawing.dll)
Visual Basic (Declaración)
Public NotInheritable Class Graphics _
Inherits MarshalByRefObject _
Implements IDeviceContext, IDisposable
public sealed class Graphics : MarshalByRefObject,
IDeviceContext, IDisposable
public ref class Graphics sealed : public MarshalByRefObject,
IDeviceContext, IDisposable
public final class Graphics extends MarshalByRefObject implements IDeviceContext,
IDisposable
public final class Graphics extends MarshalByRefObject implements IDeviceContext, IDisposable
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 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.
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 siguientes acciones:
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 Sub DrawImagePointF(ByVal e As PaintEventArgs)
' Create image.
Dim newImage As Image = Image.FromFile("SampImag.jpg")
' Create point for upper-left corner of image.
Dim ulCorner As New PointF(100.0F, 100.0F)
' Draw image to screen.
e.Graphics.DrawImage(newImage, ulCorner)
End Sub
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);
}
private:
void DrawImagePointF( PaintEventArgs^ e )
{
// Create image.
Image^ newImage = Image::FromFile( "SampImag.jpg" );
// Create point for upper-left corner of image.
PointF ulCorner = PointF(100.0F,100.0F);
// Draw image to screen.
e->Graphics->DrawImage( newImage, ulCorner );
}
System..::.Object
System..::.MarshalByRefObject
System.Drawing..::.Graphics
Seguridad para subprocesos
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
.NET Framework
Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0
.NET Compact Framework
Compatible con: 3.5, 2.0, 1.0
Referencia
Otros recursos