Control.Background Properti

Definisi

Ruang nama:

System.Windows.Controls

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur kuas yang menggambarkan latar belakang kontrol.

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

Nilai Properti

Brush

Kuas yang digunakan untuk mengisi latar belakang kontrol. Defaultnya adalah Transparent.

Atribut

BindableAttribute

Contoh

Contoh berikut menunjukkan cara mengatur properti latar belakang kontrol.

<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

Contoh berikut menunjukkan templat yang memungkinkan pemicu untuk mengubah latar belakang tombol saat ditekan.

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

Keterangan

Properti Background hanya berlaku untuk status kontrol lainnya. Gaya default kontrol menentukan tampilannya ketika status kontrol berubah. Misalnya, jika Anda mengatur Background properti pada Button, tombol memiliki nilai tersebut hanya ketika tidak ditekan atau dinonaktifkan. Jika Anda ingin membuat kontrol yang memiliki kustomisasi latar belakang yang lebih canggih, Anda harus menentukan gaya kontrol.

Properti ini hanya memengaruhi kontrol yang templatnya menggunakan Background properti sebagai parameter. Pada kontrol lain, properti ini tidak berdampak.

Informasi Properti Dependensi

Item	Nilai
Bidang pengidentifikasi	BackgroundProperty
Properti metadata diatur ke true	AffectsRender, SubPropertiesDoNotAffectRender