Control.Background Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Controls

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia pędzla opisującego tło kontrolki.

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

Wartość właściwości

Brush

Pędzel używany do wypełniania tła kontrolki. Wartość domyślna to Transparent.

Atrybuty

BindableAttribute

Przykłady

W poniższym przykładzie pokazano, jak ustawić właściwość tła kontrolki.

<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

W poniższym przykładzie pokazano szablon, który umożliwia wyzwalaczowi zmianę tła przycisku po naciśnięciu przycisku.

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

Uwagi

Właściwość Background ma zastosowanie tylko do stanu spoczynku kontrolki. Domyślny styl kontrolki określa jego wygląd po zmianie stanu kontrolki. Jeśli na przykład ustawisz Background właściwość na Buttonobiekcie , przycisk ma wartość tylko wtedy, gdy nie jest ona naciśnięta lub wyłączona. Jeśli chcesz utworzyć kontrolkę, która ma bardziej zaawansowane dostosowywanie tła, musisz zdefiniować styl kontrolki.

Ta właściwość ma wpływ tylko na kontrolkę, której szablon używa Background właściwości jako parametru. Ta właściwość nie ma wpływu na inne kontrolki.

Informacje dotyczące właściwości zależności

Pole identyfikatora	BackgroundProperty
Właściwości metadanych ustawione na true	AffectsRender, SubPropertiesDoNotAffectRender