ToolStripItem.BackColor ToolStripItem.BackColor ToolStripItem.BackColor ToolStripItem.BackColor Property

Definição

Obtém ou define a cor da tela de fundo do item.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

Valor da propriedade

Um Color que representa a cor da tela de fundo do item.A Color that represents the background color of the item. O padrão é o valor da propriedade DefaultBackColor.The default is the value of the DefaultBackColor property.

Exemplos

O exemplo de código a seguir demonstra como usar BackColor a propriedade para renderização personalizada.The following code example demonstrates how to use the BackColor property for custom rendering. Este exemplo de código faz parte de um exemplo maior fornecido para ToolStripItem a classe.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

Comentários

A BackColor propriedade não oferece suporte a cores transparentes, System.Windows.Forms.ControlStyles a menos que trueo SupportsTransparentBackColor valor de seja definido como.The BackColor property does not support transparent colors unless the SupportsTransparentBackColor value of System.Windows.Forms.ControlStyles is set to true.

A BackColor propriedade é uma propriedade de ambiente.The BackColor property is an ambient property. Uma propriedade de ambiente é uma propriedade de controle que, se não definida, é recuperada do controle pai.An ambient property is a control property that, if not set, is retrieved from the parent control. Por exemplo, um Button tem o mesmo BackColor que seu pai Form por padrão.For example, a Button has the same BackColor as its parent Form by default. Para obter mais informações sobre as propriedades de ambiente AmbientProperties , consulte a Control classe ou a visão geral da classe.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Notas aos Herdeiros

Ao substituir a BackColor Propriedade em uma classe derivada, use a propriedade da BackColor classe base para estender a implementação de base.When overriding the BackColor property in a derived class, use the base class's BackColor property to extend the base implementation. Caso contrário, você deve fornecer toda a implementação.Otherwise, you must provide all the implementation. Não é necessário substituir get os acessadores e set os acessadores da BackColor Propriedade; você pode substituir apenas um, se necessário.You are not required to override both the get and set accessors of the BackColor property; you can override only one if needed.

Aplica-se a