Control.Background 属性

public:
 property System::Windows::Media::Brush ^ Background { System::Windows::Media::Brush ^ get(); void set(System::Windows::Media::Brush ^ value); };

[System.ComponentModel.Bindable(true)]
public System.Windows.Media.Brush Background { get; set; }

member this.Background : System.Windows.Media.Brush with get, set

Public Property Background As Brush

属性值

属性

BindableAttribute

示例

下面的示例演示如何设置控件的背景属性。The following example shows how to set the background property of a control.

<Button Name="btn" Background="Red" 
        Click="ChangeBackground">
  Background
</Button>

void ChangeBackground(object sender, RoutedEventArgs e)
{
    if (btn.Background == Brushes.Red)
    {
        btn.Background = new LinearGradientBrush(Colors.LightBlue, Colors.SlateBlue, 90);
        btn.Content = "Control background changes from red to a blue gradient.";
    }
    else
    {
        btn.Background = Brushes.Red;
        btn.Content = "Background";
    }
}

Private Sub ChangeBackground(ByVal Sender As Object, ByVal e As RoutedEventArgs)

    If (Equals(btn.Background, Brushes.Red)) Then

        btn.Background = New LinearGradientBrush(Colors.LightBlue, Colors.SlateBlue, 90)
        btn.Content = "Control background changes from red to a blue gradient."

    Else

        btn.Background = Brushes.Red
        btn.Content = "Background"

    End If
End Sub

下面的示例演示一个模板, 该模板启用触发器以便在按下按钮时更改按钮的背景。The following example shows a template that enables a trigger to change the background of a button when it is pressed.

<Button FontSize="16" FontWeight="Bold">Click the Background
  <Button.Template>
    <ControlTemplate TargetType="{x:Type Button}">
      <Border Background="{TemplateBinding Background}">
         <ContentPresenter/>
      </Border>
    </ControlTemplate>
  </Button.Template>

  <Button.Style>
    <Style TargetType="{x:Type Button}">
      <Setter Property="Background" Value="Blue"/>
      <Style.Triggers>
        <Trigger Property="IsPressed" Value="true">
          <Setter Property="Background" Value="Red"/>
        </Trigger>
      </Style.Triggers>
    </Style>
  </Button.Style>
</Button>

注解

此Background属性仅适用于控件的静止状态。The Background property applies only to the resting state of a control. 控件的状态发生更改时, 控件的默认样式指定其外观。The default style of the control specifies its appearance when the state of the control changes. 例如, 如果在Background Button上设置属性, 则只有未按下或禁用此按钮时, 该按钮才具有该值。For example, if you set the Background property on a Button, the button has that value only when it is not pressed or disabled. 若要创建具有更高级的背景自定义的控件, 必须定义该控件的样式。If you want to create a control that has a more advanced customization of the background, you must define the control's style.

此属性仅影响其模板使用Background属性作为参数的控件。This property only affects a control whose template uses the Background property as a parameter. 在其他控件上, 此属性不会有任何影响。On other controls, this property has no impact.

依赖项属性信息Dependency Property Information

标识符字段Identifier field	BackgroundProperty
元数据属性设置为trueMetadata properties set to true	AffectsRender， SubPropertiesDoNotAffectRenderAffectsRender, SubPropertiesDoNotAffectRender

适用于