PaintEventArgs Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

PaintEventArgs.cs

Proporciona datos para el evento Paint.

C#

public class PaintEventArgs : EventArgs, IDisposable, System.Drawing.IDeviceContext

Herencia

Object

EventArgs

PaintEventArgs

Derivado

System.Windows.Forms.TableLayoutCellPaintEventArgs

Implementaciones

IDisposable IDeviceContext

Ejemplos

En el ejemplo siguiente se muestra cómo controlar el Paint evento y usar la PaintEventArgs clase para dibujar rectángulos en el formulario. Los MouseDown eventos y MouseUp se controlan para determinar el tamaño del rectángulo. En el ejemplo también se muestra el Invalidate método para invalidar el área del rectángulo, lo que hace que se vuelva a dibujar.

C#

private Rectangle RcDraw;
private float PenWidth = 5;

private void Form1_MouseDown(object sender, System.Windows.Forms.MouseEventArgs e)
{

    // Determine the initial rectangle coordinates...

    RcDraw.X = e.X;
    RcDraw.Y = e.Y;
}

private void Form1_MouseUp(object sender, System.Windows.Forms.MouseEventArgs e)
{

    // Determine the width and height of the rectangle...

    if(e.X < RcDraw.X)
    {
        RcDraw.Width = RcDraw.X - e.X;
        RcDraw.X = e.X;
    }
    else
    {
        RcDraw.Width = e.X - RcDraw.X;
    }

    if(e.Y < RcDraw.Y)
    {
        RcDraw.Height = RcDraw.Y - e.Y;
        RcDraw.Y = e.Y;
    }
    else
    {
        RcDraw.Height = e.Y - RcDraw.Y;
    }

    // Force a repaint of the region occupied by the rectangle...

    this.Invalidate(RcDraw);
}

private void Form1_Paint(object sender, System.Windows.Forms.PaintEventArgs e)
{

    // Draw the rectangle...

    e.Graphics.DrawRectangle(new Pen(Color.Blue, PenWidth), RcDraw);
}

C#

// This example creates a PictureBox control on the form and draws to it.
// This example assumes that the Form_Load event handler method is
// connected to the Load event of the form.

private PictureBox pictureBox1 = new PictureBox();
// Cache font instead of recreating font objects each time we paint.
private Font fnt = new Font("Arial",10);
private void Form1_Load(object sender, System.EventArgs e)
{
    // Dock the PictureBox to the form and set its background to white.
    pictureBox1.Dock = DockStyle.Fill;
    pictureBox1.BackColor = Color.White;
    // Connect the Paint event of the PictureBox to the event handler method.
    pictureBox1.Paint += new System.Windows.Forms.PaintEventHandler(this.pictureBox1_Paint);

    // Add the PictureBox control to the Form.
    this.Controls.Add(pictureBox1);
}

private void pictureBox1_Paint(object sender, System.Windows.Forms.PaintEventArgs e)
{
    // Create a local version of the graphics object for the PictureBox.
    Graphics g = e.Graphics;

    // Draw a string on the PictureBox.
    g.DrawString("This is a diagonal line drawn on the control",
        fnt, System.Drawing.Brushes.Blue, new Point(30,30));
    // Draw a line in the PictureBox.
    g.DrawLine(System.Drawing.Pens.Red, pictureBox1.Left, pictureBox1.Top,
        pictureBox1.Right, pictureBox1.Bottom);
}

Comentarios

El Paint evento tiene lugar cuando se vuelve a dibujar un control. un PaintEventArgs objeto especifica el que Graphics se va a utilizar para pintar el control y el en el ClipRectangle que se va a pintar.

Para obtener información sobre el modelo de eventos, vea Control y generación de eventos.

Constructores

PaintEventArgs(Graphics, Rectangle)

Inicializa una nueva instancia de la clase PaintEventArgs con el rectángulo de recorte y el gráfico especificados.

Propiedades

ClipRectangle	Obtiene el rectángulo en el que se va a pintar.
Graphics	Obtiene los gráficos que se utilizan para pintar.

Métodos

Dispose()	Libera todos los recursos que usa PaintEventArgs.
Dispose(Boolean)	Libera los recursos no administrados que usa PaintEventArgs y, de forma opcional, libera los recursos administrados.
Finalize()	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.

Implementaciones de interfaz explícitas

IDeviceContext.GetHdc()	Devuelve el identificador de un contexto de dispositivo de Windows.
IDeviceContext.ReleaseHdc()	Libera el identificador de un contexto de dispositivo de Windows.

Se aplica a

Consulte también

• Graphics
• Rectangle