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 的值 System.Windows.Forms.ControlStyles 設定 true 為 ，否則 SupportsTransparentBackColor 屬性不支援透明色彩。

屬性 BackColor 是環境屬性。 環境屬性是控制項屬性，如果未設定，則會從父控制項擷取。 例如， Button 預設會與父系 Form 相同 BackColor 。 如需環境屬性的詳細資訊，請參閱 AmbientProperties 類別或 Control 類別概觀。

給繼承者的注意事項

在衍生類別中覆 BackColor 寫屬性時，請使用基類的 BackColor 屬性來擴充基底實作。 否則，您必須提供所有實作。 您不需要同時覆寫 get 屬性的 BackColor 和 set 存取子;您可以視需要只覆寫一個。