Control.Background Eigenschaft

Definition

Ruft einen Pinsel ab, der den Hintergrund eines Steuerelements beschreibt, oder legt diesen fest.

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; }
[<System.ComponentModel.Bindable(true)>]
member this.Background : System.Windows.Media.Brush with get, set
Public Property Background As Brush

Eigenschaftswert

Brush

Der Pinsel, mit dem der Hintergrund des Steuerelements ausgefüllt wird. Der Standardwert ist Transparent.

Attribute

Beispiele

Das folgende Beispiel zeigt, wie die Hintergrundeigenschaft eines Steuerelements festgelegt wird.

<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

Das folgende Beispiel zeigt eine Vorlage, mit der ein Trigger den Hintergrund einer Schaltfläche ändern kann, wenn sie gedrückt wird.

<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>

Hinweise

Die Background Eigenschaft gilt nur für den ruhenden Zustand eines Steuerelements. Die Standardformatvorlage des Steuerelements gibt die Darstellung an, wenn sich der Zustand des Steuerelements ändert. Wenn Sie z. B. die Background Eigenschaft für eine ButtonEigenschaft festlegen, hat die Schaltfläche diesen Wert nur, wenn sie nicht gedrückt oder deaktiviert ist. Wenn Sie ein Steuerelement erstellen möchten, das eine erweiterte Anpassung des Hintergrunds aufweist, müssen Sie die Formatvorlage des Steuerelements definieren.

Diese Eigenschaft wirkt sich nur auf ein Steuerelement aus, dessen Vorlage die Background Eigenschaft als Parameter verwendet. Bei anderen Steuerelementen hat diese Eigenschaft keine Auswirkungen.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld BackgroundProperty
Metadateneigenschaften auf true festgelegt AffectsRender, SubPropertiesDoNotAffectRender

Gilt für: