ToolStripItem.BackColor プロパティ

.NET Framework クラス ライブラリ リファレンス

ToolStripItem.BackColor プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

項目の背景色を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 BackColor As Color

Visual Basic (使用法)

Dim instance As ToolStripItem
Dim value As Color

value = instance.BackColor

instance.BackColor = value

C#

public virtual Color BackColor { get; set;
 }

C++

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

J#

/** @property */
public Color get_BackColor ()

/** @property */
public void set_BackColor (Color value)

JScript

public function get BackColor
 () : Color

public function set BackColor
 (value : Color)

プロパティ値
項目の背景色を表す Color。既定値は DefaultBackColor プロパティの値です。

解説

System.Windows.Forms.ControlStyles の SupportsTransparentBackColor 値が true に設定されない限り、BackColor プロパティは透過色をサポートしません。

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

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

使用例

BackColor プロパティを使ったカスタム レンダリングの方法を、次のコード例に示します。このコード例は、ToolStripItem クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

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

    Dim item As RolloverItem = e.Item 

    ' If the ToolSTripItem is of type RolloverItem, 
    ' perform custom rendering for the image.
    If Not (item Is 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

C#

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);
        }
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ToolStripItem クラス
ToolStripItem メンバ
System.Windows.Forms 名前空間