Control.Background Eigenschaft

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

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

BindableAttribute

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, die es einem Trigger ermöglicht, den Hintergrund einer Schaltfläche zu ändern, 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 Ruhezustand eines Steuerelements. Der Standardstil des Steuerelements gibt sein Aussehen an, wenn sich der Zustand des Steuerelements ändert. Wenn Sie beispielsweise die Background -Eigenschaft auf einem Buttonfestlegen, hat die Schaltfläche diesen Wert nur, wenn sie nicht gedrückt oder deaktiviert wird. Wenn Sie ein Steuerelement erstellen möchten, das eine erweiterte Anpassung des Hintergrunds aufweist, müssen Sie den Stil des Steuerelements definieren.

Diese Eigenschaft wirkt sich nur auf ein Steuerelement aus, dessen Vorlage die Background -Eigenschaft als Parameter verwendet. Auf andere Steuerelemente hat diese Eigenschaft keine Auswirkungen.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	BackgroundProperty
Metadateneigenschaften auf true festgelegt	AffectsRender, SubPropertiesDoNotAffectRender