ToolStripItem.BackColor Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a cor de fundo do 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 de Propriedade
A Color que representa a cor de fundo do item. O valor padrão é o valor da DefaultBackColor propriedade.
Exemplos
O exemplo de código seguinte demonstra como usar a BackColor propriedade para renderização personalizada. Este exemplo de código faz parte de um exemplo maior fornecido para a ToolStripItem classe.
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
Observações
A propriedade BackColor não suporta cores transparentes a menos que o valor SupportsTransparentBackColor de System.Windows.Forms.ControlStyles esteja definido para true.
A BackColor propriedade é uma propriedade ambiente. Uma propriedade ambiente é uma propriedade de controlo que, se não for definida, é recuperada do controlo principal. Por exemplo, a Button tem o mesmo BackColor que o seu pai Form por defeito. Para mais informações sobre propriedades ambientais, consulte a AmbientProperties classe ou a Control visão geral da classe.
Notas para Herdeiros
Ao sobrescrever a BackColor propriedade numa classe derivada, use a propriedade da BackColor classe base para estender a implementação base. Caso contrário, deve fornecer toda a implementação. Não é obrigado a anular ambos os get acessórios da set propriedadeBackColor; só pode anular um, se necessário.