ToolStripItem.BackColor 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置项的背景色。

public:
 virtual property System::Drawing::Color BackColor { System::Drawing::Color get(); void set(System::Drawing::Color value); };

public virtual System.Drawing.Color BackColor { get; set; }

member this.BackColor : System.Drawing.Color with get, set

Public Overridable Property BackColor As Color

属性值

Color

Color，表示该项的背景色。 默认为 DefaultBackColor 属性的值。

示例

下面的代码示例演示如何使用 BackColor 属性进行自定义呈现。 此代码示例是为 ToolStripItem 类提供的一个更大示例的一部分。

protected override void OnRenderItemImage(
    ToolStripItemImageRenderEventArgs e)
{
    base.OnRenderItemImage(e);

    RolloverItem item = e.Item as RolloverItem;

    // If the ToolSTripItem is of type RolloverItem, 
    // perform custom rendering for the image.
    if (item != null)
    {
        if (item.Clicked)
        {
            // The item is in the clicked state, so 
            // draw the image as usual.
            e.Graphics.DrawImage(
                e.Image,
                e.ImageRectangle.X,
                e.ImageRectangle.Y);
        }
        else
        {
            // In the unclicked state, gray out the image.
            ControlPaint.DrawImageDisabled(
                e.Graphics,
                e.Image,
                e.ImageRectangle.X,
                e.ImageRectangle.Y,
                item.BackColor);
        }
    }
}

Protected Overrides Sub OnRenderItemImage(ByVal e As ToolStripItemImageRenderEventArgs)
    MyBase.OnRenderItemImage(e)

    Dim item As RolloverItem = CType(e.Item, RolloverItem)

    ' If the ToolSTripItem is of type RolloverItem, 
    ' perform custom rendering for the image.
    If (item IsNot Nothing) Then
        If item.Clicked Then
            ' The item is in the clicked state, so 
            ' draw the image as usual.
            e.Graphics.DrawImage(e.Image, e.ImageRectangle.X, e.ImageRectangle.Y)
        Else
            ' In the unclicked state, gray out the image.
            ControlPaint.DrawImageDisabled(e.Graphics, e.Image, e.ImageRectangle.X, e.ImageRectangle.Y, item.BackColor)
        End If
    End If
End Sub

注解

属性BackColor不支持透明颜色，除非 的值SupportsTransparentBackColorSystem.Windows.Forms.ControlStyles设置为 true。

属性 BackColor 是环境属性。 环境属性是一个控件属性，如果未设置，将从父控件检索该属性。 例如， Button 默认与它的父级Form相同BackColor。 有关环境属性的详细信息，请参阅 AmbientProperties 类或 Control 类概述。

继承者说明

重写派生类中的 BackColor 属性时，使用基类的 BackColor 属性扩展基实现。 否则，必须提供所有实现。 无需同时get重写属性的 BackColor 和 set 访问器;如果需要，只能重写一个访问器。