ToolStripItem.BackColor 속성

정의

항목의 배경색을 가져오거나 설정합니다.Gets or sets the background color for the item.

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

속성 값

항목의 배경색을 나타내는 Color입니다.A Color that represents the background color of the item. 기본값은 DefaultBackColor 속성 값입니다.The default is the value of the DefaultBackColor property.

예제

다음 코드 예제를 사용 하는 방법에 설명 합니다 BackColor 속성 사용자 지정 렌더링 합니다.The following code example demonstrates how to use the BackColor property for custom rendering. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 ToolStripItem 클래스입니다.This code example is part of a larger example provided for the ToolStripItem class.

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

설명

BackColor 속성이 투명 한 색 지원 하지 않는 한는 SupportsTransparentBackColor 의 값 System.Windows.Forms.ControlStyles 로 설정 되어 true합니다.The BackColor property does not support transparent colors unless the SupportsTransparentBackColor value of System.Windows.Forms.ControlStyles is set to true.

BackColor 속성이 앰비언트 속성입니다.The BackColor property is an ambient property. 그렇지 않은 경우, 앰비언트 속성은 컨트롤 속성 설정, 부모 컨트롤에서 검색 됩니다.An ambient property is a control property that, if not set, is retrieved from the parent control. 예를 들어, 한 Button 동일 BackColor 부모로 Form 기본적으로 합니다.For example, a Button has the same BackColor as its parent Form by default. 앰비언트 속성에 대 한 자세한 내용은 참조는 AmbientProperties 클래스 또는 Control 클래스 개요입니다.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

상속자 참고

재정의 하는 경우는 BackColor 기본 클래스를 사용 하는 파생된 클래스에서 속성 BackColor 속성을 기본 구현을 확장 합니다.When overriding the BackColor property in a derived class, use the base class's BackColor property to extend the base implementation. 그렇지 않으면 전체 구현을 제공 해야 합니다.Otherwise, you must provide all the implementation. 모두 재정의할 필요가 없습니다를 getset 접근자를 BackColor 속성에 필요한 경우 하나만 재정의할 수 있습니다.You are not required to override both the get and set accessors of the BackColor property; you can override only one if needed.

적용 대상