ToolStripItem.BackColor Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

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

Объект 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.ControlStylestrueзначение .

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

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

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