PaintEventArgs クラス

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ソース:

PaintEventArgs.cs

Paint イベントのデータを提供します。

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

継承

Object

EventArgs

PaintEventArgs

派生

System.Windows.Forms.TableLayoutCellPaintEventArgs

実装

IDisposable IDeviceContext

例

次の例では、 イベントを Paint 処理し、 クラスを PaintEventArgs 使用してフォームに四角形を描画する方法を示します。 MouseDownイベントと MouseUp イベントは、四角形のサイズを決定するために処理されます。 この例では、四角形の Invalidate 領域を無効にして再描画する メソッドも示しています。

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

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

注釈

イベントは Paint 、コントロールが再描画されるときに発生します。 は PaintEventArgs 、コントロールの Graphics 描画に使用する と、描画する を ClipRectangle 指定します。

イベント モデルの詳細については、「イベントの 処理と発生」を参照してください。

コンストラクター

PaintEventArgs(Graphics, Rectangle)

指定したグラフィックとクリッピング四角形を使用して、PaintEventArgs クラスの新しいインスタンスを初期化します。

プロパティ

ClipRectangle	描画先の四角形を取得します。
Graphics	描画に使用するグラフィックスを取得します。

メソッド

Dispose()	PaintEventArgs によって使用されているすべてのリソースを解放します。
Dispose(Boolean)	PaintEventArgs によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。
Finalize()	オブジェクトが、ガベージ コレクションによって収集される前に、リソースの解放とその他のクリーンアップ操作の実行を試みることができるようにします。

明示的なインターフェイスの実装

IDeviceContext.GetHdc()	Windows デバイス コンテキストを識別するハンドルを返します。
IDeviceContext.ReleaseHdc()	Windows デバイス コンテキストのハンドルを解放します。

適用対象

こちらもご覧ください

• Graphics
• Rectangle