ToolStripItem.BackColor Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví barvu pozadí pro položku.

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

Hodnota vlastnosti

Color

A Color , která představuje barvu pozadí položky. Výchozí hodnota je hodnota DefaultBackColor vlastnosti .

Příklady

Následující příklad kódu ukazuje, jak použít BackColor vlastnost pro vlastní vykreslování. Tento příklad kódu je součástí většího příkladu ToolStripItem pro třídu .

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

Poznámky

Vlastnost BackColor nepodporuje průhledné barvy, pokud SupportsTransparentBackColor není hodnota System.Windows.Forms.ControlStyles nastavená na true.

Vlastnost BackColor je vlastnost okolí. Vlastnost okolí je vlastnost ovládacího prvku, která, pokud není nastavena, je načtena z nadřazeného ovládacího prvku. Například má Button ve výchozím nastavení stejný BackColor objekt jako jeho nadřazený Form objekt. Další informace o okolních vlastnostech naleznete v přehledu AmbientPropertiesControl třídy nebo třídy.

Poznámky pro dědice

Při přepsání BackColor vlastnosti v odvozené třídě použijte vlastnost základní třídy BackColor k rozšíření základní implementace. V opačném případě musíte zadat celou implementaci. Není nutné přepsat přístupové objekty BackColor vlastnosti a get . set V případě potřeby můžete přepsat pouze jeden.