ToolStripItem.BackColor Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit la couleur d'arrière-plan de l'élément.

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

Valeur de propriété

Color

Color qui représente la couleur d'arrière-plan de l'élément. La valeur par défaut est la valeur de la propriété DefaultBackColor.

Exemples

L’exemple de code suivant montre comment utiliser la propriété pour le BackColor rendu personnalisé. Cet exemple de code fait partie d’un exemple plus grand fourni pour 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

Remarques

La BackColor propriété ne prend pas en charge les couleurs transparentes, sauf si la SupportsTransparentBackColor valeur de celle-ci System.Windows.Forms.ControlStyles est définie truesur .

La BackColor propriété est une propriété ambiante. Une propriété ambiante est une propriété de contrôle qui, si elle n’est pas définie, est récupérée à partir du contrôle parent. Par exemple, un Button a la même BackColor valeur que son parent Form par défaut. Pour plus d’informations sur les propriétés ambiantes, consultez la AmbientProperties classe ou la vue d’ensemble de la Control classe.

Notes pour les héritiers

Lors de la substitution de la BackColor propriété dans une classe dérivée, utilisez la propriété de BackColor la classe de base pour étendre l’implémentation de base. Sinon, vous devez fournir toute l’implémentation. Vous n’êtes pas obligé de remplacer les accesseurs et set les get accesseurs de la BackColor propriété ; vous ne pouvez remplacer qu’un seul si nécessaire.