Control.Background 属性
定义
获取或设置一个用于描述控件背景的画笔。Gets or sets a brush that describes the background of a control.
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
属性值
用于填充控件背景的画笔。The brush that is used to fill the background of the control. 默认值为 Transparent。The default is Transparent.
- 属性
示例
下面的示例演示如何设置控件的背景属性。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 |
元数据属性设置为true Metadata properties set to true |
AffectsRender, SubPropertiesDoNotAffectRenderAffectsRender, SubPropertiesDoNotAffectRender |