ToolStripItem.BackColor Свойство

Определение

Возвращает или задает цвет фона для элемента.

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 представляющий цвет фона элемента. Значение по умолчанию — это значение 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 не поддерживает прозрачные цвета, если SupportsTransparentBackColor значение System.Windows.Forms.ControlStyles не задано true.

Свойство BackColor является внешним свойством. Внешнее свойство — это свойство элемента управления, которое, если оно не задано, извлекается из родительского элемента управления. Например, по умолчанию он Button совпадает BackColor с родительским Form элементом. Дополнительные сведения о свойствах окружающей среды см. в обзоре AmbientPropertiesControl класса или класса.

Примечания для тех, кто наследует этот метод

При переопределении BackColor свойства в производном классе используйте свойство базового класса BackColor для расширения базовой реализации. В противном случае необходимо предоставить всю реализацию. Вам не требуется переопределить и getset методы BackColor доступа свойства. При необходимости можно переопределить только один из них.

Применяется к