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

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 プロパティがテンプレートでパラメータとして使用されているコントロールだけです。その他のコントロールには影響はありません。

コントロールの 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
表示: