Språk

ToolStripItem.BackColor Egenskap

Definition

Hämtar eller anger bakgrundsfärgen för objektet.

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

Egenskapsvärde

En Color som representerar objektets bakgrundsfärg. Standardvärdet är egenskapens DefaultBackColor värde.

Exempel

I följande kodexempel visas hur du använder egenskapen BackColor för anpassad återgivning. Det här kodexemplet är en del av ett större exempel för ToolStripItem klassen.

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

Kommentarer

Egenskapen BackColor stöder inte transparenta färger om inte värdet SupportsTransparentBackColor för System.Windows.Forms.ControlStyles är inställt på true.

Egenskapen BackColor är en omgivande egenskap. En omgivande egenskap är en kontrollegenskap som, om den inte anges, hämtas från den överordnade kontrollen. Till exempel har en Button samma BackColor som dess överordnade Form som standard. Mer information om omgivande egenskaper finns i AmbientProperties klassen eller klassöversikten Control .

Anteckningar till arvingar

När du åsidosättar BackColor egenskapen i en härledd klass använder du basklassens BackColor egenskap för att utöka basimplementeringen. Annars måste du ange all implementering. Du behöver inte åsidosätta både get egenskapens och set -åtkomsten BackColor . Du kan bara åsidosätta en om det behövs.

Gäller för