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が に設定されていない限り、 SupportsTransparentBackColor プロパティは透明色をtrueサポートしません。

プロパティは BackColor アンビエント プロパティです。 アンビエント プロパティは、設定されていない場合は親コントロールから取得されるコントロール プロパティです。 たとえば、 Button は既定で親Formと同じですBackColor。 アンビエント プロパティの詳細については、クラスまたはクラスの AmbientProperties 概要に関するページを Control 参照してください。

注意 (継承者)

派生クラスの プロパティをオーバーライドする BackColor 場合は、基底クラスの BackColor プロパティを使用して基本実装を拡張します。 それ以外の場合は、すべての実装を指定する必要があります。 プロパティの アクセサーと set アクセサーのBackColor両方をgetオーバーライドする必要はありません。必要な場合は 1 つだけをオーバーライドできます。