Control.Background Свойство

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

Возвращает или задает кисть, описывающую фон элемента управления.

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

Значение свойства

Brush

Кисть, используемая для заполнения фона элемента управления. Значение по умолчанию — Transparent.

Атрибуты

BindableAttribute

Примеры

В следующем примере показано, как задать фоновое свойство элемента управления.

<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

В следующем примере показан шаблон, позволяющий триггеру изменять фон кнопки при нажатии.

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

Комментарии

Свойство Background применяется только к остальному состоянию элемента управления. Стиль элемента управления по умолчанию указывает его внешний вид при изменении состояния элемента управления. Например, если для свойства задано Background значение Button, кнопка имеет это значение только в том случае, если он не нажимается или не отключается. Если вы хотите создать элемент управления с более расширенной настройкой фона, необходимо определить стиль элемента управления.

Это свойство влияет только на элемент управления, шаблон которого использует Background свойство в качестве параметра. В других элементах управления это свойство не влияет.

Сведения о свойстве зависимостей

Элемент	Ценность
Поле идентификатора	BackgroundProperty
Свойства метаданных, равные свойству true	AffectsRender, SubPropertiesDoNotAffectRender