Auf Englisch lesen

Freigeben über


Control.Paint Ereignis

Definition

Tritt ein, wenn das Steuerelement neu gezeichnet wird.

public event System.Windows.Forms.PaintEventHandler Paint;
public event System.Windows.Forms.PaintEventHandler? Paint;

Ereignistyp

Beispiele

Im folgenden Codebeispiel wird ein PictureBox Steuerelement für das Formular erstellt und das Paint -Ereignis verwendet, um es zu zeichnen.

// 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);
}

Hinweise

Das Paint Ereignis wird ausgelöst, wenn das Steuerelement neu gezeichnet wird. Er übergibt eine instance von PaintEventArgs an die Methode(en), die das Paint Ereignis behandelt.

Beim Erstellen eines neuen benutzerdefinierten Steuerelements oder eines geerbten Steuerelements mit einer anderen visuellen Darstellung müssen Sie Code bereitstellen, um das Steuerelement zu rendern, indem Sie die OnPaint -Methode überschreiben. Weitere Informationen finden Sie unter Überschreiben der OnPaint-Methode und Benutzerdefiniertes Steuerelementmalen und Rendern.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Gilt für:

Produkt Versionen
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Weitere Informationen