ToolStripItem.BackColor Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die Hintergrundfarbe für das Element ab oder legt diese fest.

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

Eigenschaftswert

Color

Eine Color, die die Hintergrundfarbe des Elements darstellt. Der Standardwert ist der Wert der DefaultBackColor-Eigenschaft.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die -Eigenschaft für das BackColor benutzerdefinierte Rendering verwendet wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ToolStripItem-Klasse bereitgestellt wird.

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

Hinweise

Die BackColor -Eigenschaft unterstützt keine transparenten Farben, es sei denn, der SupportsTransparentBackColor Wert von System.Windows.Forms.ControlStyles ist auf truefestgelegt.

Die BackColor -Eigenschaft ist eine Ambient-Eigenschaft. Eine Ambient-Eigenschaft ist eine Steuerelementeigenschaft, die, wenn sie nicht festgelegt ist, aus dem übergeordneten Steuerelement abgerufen wird. Beispielsweise hat ein Button standardmäßig dasselbe BackColor wie sein übergeordnetes Form Element. Weitere Informationen zu Ambient-Eigenschaften finden Sie in der AmbientProperties -Klasse oder in der Übersicht über die Control Klasse.

Hinweise für Vererber

Verwenden Sie beim Überschreiben der BackColor -Eigenschaft in einer abgeleiteten Klasse die -Eigenschaft der BackColor Basisklasse, um die Basisimplementierung zu erweitern. Andernfalls müssen Sie die gesamte Implementierung bereitstellen. Sie müssen nicht sowohl die Accessoren als set auch die get Accessoren der BackColor -Eigenschaft außer Kraft setzen. Sie können bei Bedarf nur einen überschreiben.