このドキュメントはアーカイブされており、メンテナンスされていません。

Control.Background プロパティ

コントロールの背景を表すブラシを取得または設定します。これは、依存関係プロパティです。

名前空間: System.Windows.Controls
アセンブリ: PresentationFramework (presentationframework.dll 内)
XML 名前空間 :  http://schemas.microsoft.com/winfx/2006/xaml/presentation

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

/** @property */
public void set_Background (Brush value)

public function get Background () : Brush

public function set Background (value : Brush)

XAML の詳細については、Brush 型を参照してください。

プロパティ値

コントロールの背景の塗りつぶしに使用するブラシ。既定値は、Transparent です。

識別子フィールド

BackgroundProperty

true に設定されたメタデータのプロパティ。

なし

Background プロパティは、コントロールの休止状態にのみ適用されます。コントロールの状態が変化したときの外観は、コントロールの既定のスタイルで指定します。たとえば、ButtonBackground プロパティを設定した場合、その値が適用されるのは、ボタンが押されたり無効になったりしていないときだけです。作成するコントロールでより高度な背景のカスタマイズが必要な場合は、コントロールのスタイルを定義する必要があります。

コントロールの Background プロパティを設定する方法を次の例に示します。

<Button Name="btn" Background="Red" Click="ChangeBackground">Background</Button>

if (btn.Background == Brushes.Red)
{
    btn.Background = new LinearGradientBrush(Colors.LightBlue, Colors.SlateBlue, 90);
    btn.Content = "Background";
}
else
{
    btn.Background = Brushes.Red;
    btn.Content = "Control background changes from red to a blue gradient.";
}

ボタンが押された場合にボタンの背景を変更できるようにするテンプレートを次の例に示します。

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

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

.NET Framework

サポート対象 : 3.0
表示: