ToolStripItem.BackColor Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta il colore di sfondo dell'elemento.

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

Valore della proprietà

Color

Oggetto Color che rappresenta il colore di sfondo dell'elemento. Il valore predefinito corrisponde al valore della proprietà DefaultBackColor.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la proprietà per il BackColor rendering personalizzato. Questo esempio di codice fa parte di un esempio più grande fornito per la 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

Commenti

La BackColor proprietà non supporta i colori trasparenti a meno che il SupportsTransparentBackColor valore di System.Windows.Forms.ControlStyles sia impostato su true.

La BackColor proprietà è una proprietà di ambiente. Una proprietà ambient è una proprietà di controllo che, se non è impostata, viene recuperata dal controllo padre. Ad esempio, un oggetto Button ha lo stesso valore BackColor padre Form per impostazione predefinita. Per altre informazioni sulle proprietà dell'ambiente, vedere la classe o la AmbientProperties panoramica della Control classe.

Note per gli eredi

Quando si esegue l'override della proprietà in una classe derivata, usare la BackColor proprietà della BackColor classe di base per estendere l'implementazione di base. In caso contrario, è necessario fornire tutte le implementazioni. Non è necessario eseguire l'override di entrambe le get funzioni di accesso e set della proprietà. È possibile eseguire l'override BackColor di uno solo se necessario.