Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch
Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

Control.Background-Eigenschaft

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

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

[BindableAttribute(true)]
public Brush Background { get; set; }

Eigenschaftswert

Typ: System.Windows.Media.Brush
Der Pinsel, mit dem der Hintergrund des Steuerelements ausgefüllt wird. Der Standardwert ist Brushes.Transparent.

Die Background-Eigenschaft gilt nur für den Ruhezustand eines Steuerelements. Das Standardformat des Steuerelements gibt seine Darstellung an, wenn der Zustand des Steuerelements geändert wird. Wenn Sie z. B. die Background-Eigenschaft in einem Button festlegen, gilt dieser Wert nur dann für die Schaltfläche, wenn auf diese nicht geklickt wird und sie nicht deaktiviert ist. Wenn Sie ein Steuerelement erstellen möchten, das über mehrere erweiterte Hintergrundanpassungen verfügt, müssen Sie die Formatvorlage des Steuerelements definieren.

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

Im folgenden Beispiel wird veranschaulicht, wie die Hintergrundeigenschaft eines Steuerelements festgelegt wird.


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



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



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";
    }
}


Im folgenden Beispiel wird eine Vorlage veranschaulicht, die es einem Auslöser ermöglicht, den Hintergrund einer Schaltfläche zu ändern, wenn auf diese geklickt 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>


.NET Framework

Unterstützt in: 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Anzeigen: