ToolStripItem.BackColor Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

ToolStripItem.cs

Öğenin arka plan rengini alır veya ayarlar.

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

Özellik Değeri

Color

Color Öğenin arka plan rengini temsil eden bir. Varsayılan, özelliğin DefaultBackColor değeridir.

Örnekler

Aşağıdaki kod örneği, özel işleme için özelliğinin BackColor nasıl kullanılacağını gösterir. Bu kod örneği, sınıfı için ToolStripItem sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

BackColor özelliği, değeri System.Windows.Forms.ControlStyles olarak ayarlanmadığı truesürece SupportsTransparentBackColor saydam renkleri desteklemez.

BackColor özelliği bir ortam özelliğidir. Ortam özelliği, ayarlanmadıysa üst denetimden alınan bir denetim özelliğidir. Örneğin, varsayılan Button olarak üst öğesiyle Form aynıdırBackColor. Ortam özellikleri hakkında daha fazla bilgi için bkz. sınıfa AmbientProperties veya sınıfa Control genel bakış.

Devralanlara Notlar

Türetilmiş bir sınıfta özelliğini BackColor geçersiz kıldığınızda temel uygulamanın kapsamını genişletmek için temel sınıfın BackColor özelliğini kullanın. Aksi takdirde, tüm uygulamayı sağlamanız gerekir. Özelliğin get hem hem set de erişimcilerini BackColor geçersiz kılmanız gerekmez; gerekirse yalnızca birini geçersiz kılabilirsiniz.