이 설명서는 보관되지만 유지 되지 않습니다.

Control.Background 속성

업데이트: 2007년 11월

컨트롤의 배경을 설명하는 브러시를 가져오거나 설정합니다. 이 속성은 종속성 속성입니다.

네임스페이스:  System.Windows.Controls
어셈블리:  PresentationFramework(PresentationFramework.dll)

[BindableAttribute(true)]
public Brush Background { get; set; }
/** @property */
/** @attribute BindableAttribute(true) */
public Brush get_Background()
/** @property */
/** @attribute BindableAttribute(true) */
public  void set_Background(Brush value)

public function get Background () : Brush
public function set Background (value : Brush)
XAML에 대한 내용은 Brush 형식을 참조하십시오.

속성 값

형식: System.Windows.Media.Brush

컨트롤의 배경을 채우는 데 사용되는 브러시입니다. 기본값은 Brushes.Transparent입니다.

식별자 필드

BackgroundProperty

true로 설정된 메타데이터 속성

AffectsRender, SubPropertiesDoNotAffectRender

Background 속성은 컨트롤이 휴면 상태일 때만 적용됩니다. 컨트롤의 기본 스타일은 컨트롤의 상태가 변경될 때의 모양을 지정합니다. 예를 들어 ButtonBackground 속성을 설정하면 단추를 누르지 않거나 사용할 수 없을 때만 이 값이 적용됩니다. 컨트롤의 배경을 보다 자세히 사용자 지정하려면 컨트롤 스타일을 정의해야 합니다.

이 속성은 해당 템플릿에서 Background 속성을 매개 변수로 사용하는 컨트롤에만 영향을 줍니다. 이 속성은 다른 컨트롤에는 아무런 영향을 주지 않습니다.

다음 예제에서는 컨트롤의 배경 속성을 설정하는 방법을 보여 줍니다.

<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";
    }
}


다음 예제에서는 단추를 누를 때 배경을 변경하는 트리거를 사용하는 템플릿을 보여 줍니다.

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


Windows Vista

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

.NET Framework

3.5, 3.0에서 지원
표시: