ToolStripItem.BackColor プロパティ

定義

項目の背景色を取得または設定します。Gets or sets the background color for the item.

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

プロパティ値

項目の背景色を表す ColorA Color that represents the background color of the item. 既定値は DefaultBackColor プロパティの値です。The default is the value of the DefaultBackColor property.

次のコード例は、 BackColorカスタム表示にプロパティを使用する方法を示しています。The following code example demonstrates how to use the BackColor property for custom rendering. このコード例は、 ToolStripItemクラスに対して提供される大規模な例の一部です。This code example is part of a larger example provided for the ToolStripItem class.

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は、のSupportsTransparentBackColor System.Windows.Forms.ControlStyles値がに設定されていない限りtrue、透明色をサポートしません。The BackColor property does not support transparent colors unless the SupportsTransparentBackColor value of System.Windows.Forms.ControlStyles is set to true.

BackColorプロパティはアンビエントプロパティです。The BackColor property is an ambient property. アンビエントプロパティは、設定されていない場合、親コントロールから取得されるコントロールプロパティです。An ambient property is a control property that, if not set, is retrieved from the parent control. たとえば、既定でButtonは、はBackColorその親Formと同じです。For example, a Button has the same BackColor as its parent Form by default. アンビエントプロパティの詳細についてAmbientProperties Controlは、クラスまたはクラスの概要に関するトピックを参照してください。For more information about ambient properties, see the AmbientProperties class or the Control class overview.

注意 (継承者)

派生クラスのBackColorプロパティをオーバーライドする場合は、基本クラスのBackColorプロパティを使用して基本実装を拡張します。When overriding the BackColor property in a derived class, use the base class's BackColor property to extend the base implementation. それ以外の場合は、すべての実装を指定する必要があります。Otherwise, you must provide all the implementation. プロパティのset get アクセサーとアクセサーの両方をオーバーライドする必要はありません。必要な場合は、1つだけをオーバーライドできます。BackColorYou are not required to override both the get and set accessors of the BackColor property; you can override only one if needed.

適用対象