ToolStripItemRenderEventArgs 类

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

ToolStripItemRenderEventArgs.cs

为事件提供数据，这些事件在 ToolStripItem 类中呈现派生自 ToolStripRenderer 的对象的背景。

C#

public class ToolStripItemRenderEventArgs : EventArgs

继承

Object

EventArgs

ToolStripItemRenderEventArgs

派生

System.Windows.Forms.ToolStripItemImageRenderEventArgs

System.Windows.Forms.ToolStripItemTextRenderEventArgs

System.Windows.Forms.ToolStripSeparatorRenderEventArgs

示例

下面的代码示例演示如何重写 方法，OnRenderButtonBackground以在控件的 Image周围ToolStripButton绘制边框。 此代码示例是为 ToolStripRenderer 类提供的一个更大示例的一部分。

C#

// This method draws a border around the button's image. If the background
// to be rendered belongs to the empty cell, a string is drawn. Otherwise,
// a border is drawn at the edges of the button.
protected override void OnRenderButtonBackground(
    ToolStripItemRenderEventArgs e)
{
    base.OnRenderButtonBackground(e);

    // Define some local variables for convenience.
    Graphics g = e.Graphics;
    GridStrip gs = e.ToolStrip as GridStrip;
    ToolStripButton gsb = e.Item as ToolStripButton;

    // Calculate the rectangle around which the border is painted.
    Rectangle imageRectangle = new Rectangle(
        borderThickness, 
        borderThickness, 
        e.Item.Width - 2 * borderThickness, 
        e.Item.Height - 2 * borderThickness);

    // If rendering the empty cell background, draw an 
    // explanatory string, centered in the ToolStripButton.
    if (gsb == gs.EmptyCell)
    {
        e.Graphics.DrawString(
            "Drag to here",
            gsb.Font, 
            SystemBrushes.ControlDarkDark,
            imageRectangle, style);
    }
    else
    {
        // If the button can be a drag source, paint its border red.
        // otherwise, paint its border a dark color.
        Brush b = gs.IsValidDragSource(gsb) ? b = 
            Brushes.Red : SystemBrushes.ControlDarkDark;

        // Draw the top segment of the border.
        Rectangle borderSegment = new Rectangle(
            0, 
            0, 
            e.Item.Width, 
            imageRectangle.Top);
        g.FillRectangle(b, borderSegment);

        // Draw the right segment.
        borderSegment = new Rectangle(
            imageRectangle.Right,
            0,
            e.Item.Bounds.Right - imageRectangle.Right,
            imageRectangle.Bottom);
        g.FillRectangle(b, borderSegment);

        // Draw the left segment.
        borderSegment = new Rectangle(
            0,
            0,
            imageRectangle.Left,
            e.Item.Height);
        g.FillRectangle(b, borderSegment);

        // Draw the bottom segment.
        borderSegment = new Rectangle(
            0,
            imageRectangle.Bottom,
            e.Item.Width,
            e.Item.Bounds.Bottom - imageRectangle.Bottom);
        g.FillRectangle(b, borderSegment);
    }
}

注解

类 ToolStripItemRenderEventArgs 提供以下事件的数据：

• RenderButtonBackground

• RenderDropDownButtonBackground

• RenderItemBackground

• RenderLabelBackground

• RenderMenuItemBackground

• RenderOverflowButtonBackground

• RenderSplitButtonBackground

此外，它还提供以下方法的数据：

• DrawButtonBackground

• DrawDropDownButtonBackground

• DrawItemBackground

• DrawLabelBackground

• DrawMenuItemBackground

• DrawOverflowButtonBackground

• DrawSplitButton

构造函数

ToolStripItemRenderEventArgs(Graphics, ToolStripItem)

使用指定的 ToolStripItemRenderEventArgs 为指定的 ToolStripItem 初始化 Graphics 的新实例。

属性

Graphics	获取用于绘制 ToolStripItem 的图形。
Item	获取要绘制的 ToolStripItem。
ToolStrip	获取要绘制的 Owner 的 ToolStripItem 属性的值。

适用于

另请参阅

• ToolStripRenderer
• ToolStripProfessionalRenderer
• ToolStripSystemRenderer
• 如何：实现自定义 ToolStripRenderer