Control.Background Vlastnost

Definice

Obor názvů:

System.Windows.Controls

Sestavení:

PresentationFramework.dll

Získá nebo nastaví štětec, který popisuje pozadí ovládacího prvku.

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

Hodnota vlastnosti

Brush

Štětec, který se používá k vyplnění pozadí ovládacího prvku. Výchozí formát je Transparent.

Atributy

BindableAttribute

Příklady

Následující příklad ukazuje, jak nastavit vlastnost background ovládacího prvku.

<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

Následující příklad ukazuje šablonu, která triggeru umožňuje změnit pozadí tlačítka při jeho stisknutí.

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

Poznámky

Vlastnost Background se vztahuje pouze na klidový stav ovládacího prvku. Výchozí styl ovládacího prvku určuje jeho vzhled při změně stavu ovládacího prvku. Pokud například nastavíte Background vlastnost u Button, bude toto tlačítko tuto hodnotu jenom v případě, že není stisknutá nebo zakázaná. Pokud chcete vytvořit ovládací prvek, který má pokročilejší přizpůsobení pozadí, musíte definovat styl ovládacího prvku.

Tato vlastnost ovlivňuje pouze ovládací prvek, jehož šablona používá Background vlastnost jako parametr. Na jiné ovládací prvky tato vlastnost nemá žádný vliv.

Informace o vlastnosti závislosti

Pole Identifikátor	BackgroundProperty
Vlastnosti metadat nastavené na true	AffectsRender, SubPropertiesDoNotAffectRender