ToolStripItem.OnPaint(PaintEventArgs) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

ToolStripItem.cs

引发 Paint 事件。

C#

protected virtual void OnPaint(System.Windows.Forms.PaintEventArgs e);

参数

e

PaintEventArgs

包含事件数据的 PaintEventArgs。

示例

下面的代码示例演示如何重写 OnPaint 方法进行自定义呈现。 此代码示例是为 ToolStripItem 类提供的一个更大示例的一部分。

C#

// This method defines the painting behavior of the control.
// It performs the following operations:
//
// Computes the layout of the item's image and text.
// Draws the item's background image.
// Draws the item's image.
// Draws the item's text.
//
// Drawing operations are implemented in the 
// RolloverItemRenderer class.
protected override void OnPaint(PaintEventArgs e)
{
    base.OnPaint(e);

    if (this.Owner != null)
    {
        // Find the dimensions of the image and the text 
        // areas of the item. 
        this.ComputeImageAndTextLayout();

        // Draw the background. This includes drawing a highlighted 
        // border when the mouse is in the client area.
        ToolStripItemRenderEventArgs ea = new ToolStripItemRenderEventArgs(
             e.Graphics,
             this);
        this.Owner.Renderer.DrawItemBackground(ea);

        // Draw the item's image. 
        ToolStripItemImageRenderEventArgs irea =
            new ToolStripItemImageRenderEventArgs(
            e.Graphics,
            this,
            imageRect );
        this.Owner.Renderer.DrawItemImage(irea);

        // If the item is on a drop-down, give its
        // text a different highlighted color.
        Color highlightColor = 
            this.IsOnDropDown ?
            Color.Salmon : SystemColors.ControlLightLight;

        // Draw the text, and highlight it if the 
        // the rollover state is true.
        ToolStripItemTextRenderEventArgs rea =
            new ToolStripItemTextRenderEventArgs(
            e.Graphics,
            this,
            base.Text,
            textRect,
            this.rolloverValue ? highlightColor : base.ForeColor,
            base.Font,
            base.TextAlign);
        this.Owner.Renderer.DrawItemText(rea);
    }
}

注解

引发事件时，将通过委托调用事件处理程序。 有关详细信息，请参阅 处理和引发事件。

OnPaint 方法还允许派生类对事件进行处理而不必附加委托。 这是在派生类中处理事件的首选技术。

继承者说明

在派生类中重写 OnPaint(PaintEventArgs) 时，一定要调用基类的 OnPaint(PaintEventArgs) 方法，以便已注册的委托对事件进行接收。

适用于