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ý slouží 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 pozadí 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á umožňuje triggeru změnit pozadí tlačítka při stisknutí tlačítka.

<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 zbývající stav ovládacího prvku. Výchozí styl ovládacího prvku určuje jeho vzhled, když se změní stav ovládacího prvku. Pokud například nastavíte Background vlastnost na Button, tlačítko má tuto hodnotu pouze v případě, že není stisknuto nebo zakázáno. 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 má vliv pouze na ovládací prvek, jehož šablona používá Background vlastnost jako parametr. U jiných ovládacích prvků tato vlastnost nemá žádný vliv.

Informace o vlastnosti závislosti

Pole identifikátoru	BackgroundProperty
Vlastnosti metadat nastavené na true	AffectsRender, SubPropertiesDoNotAffectRender