Control.Background プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コントロールの背景を提供するブラシを取得または設定します。
public:
property Brush ^ Background { Brush ^ get(); void set(Brush ^ value); };
Brush Background();
void Background(Brush value);
public Brush Background { get; set; }
var brush = control.background;
control.background = brush;
Public Property Background As Brush
<control Background="{StaticResource resourceName}"/>
- or -
<control Background="colorString"/>
- or -
<control>
<control.Background>singleBrush</control.Background>
</control>
プロパティ値
コントロールの背景を提供するブラシ。 既定値は null (null ブラシ) で、レンダリングでは Transparent と評価されます。
注釈
各コントロールでは、ビジュアル テンプレートに基づいて、このプロパティの適用方法が異なる場合があります。 このプロパティは、テンプレートの UI プロパティの入力として Background プロパティを使用するコントロールにのみ影響します。 他のコントロールでは、このプロパティは無効です。 通常、コントロールは {TemplateBinding} マークアップ拡張を使用して、その Background 値をコントロール テンプレートのルート要素である Panel の Background にバインドします。たとえば、 から ですGrid.Background
。 ビジュアル テンプレートとコントロール テンプレートの詳細については、「 コントロールのスタイル設定 」または 「Template プロパティのリファレンス ページ」を参照してください。
Windows 10 バージョン 1607 (Windows Software Development Kit (SDK) バージョン 10.0.14393.0 以降)、generic.xaml には、コントロール テンプレートを変更せずにさまざまなビジュアル状態のコントロールの色を変更するために使用できるリソースが含まれています。 このソフトウェア開発キット (SDK) 以降を対象とするアプリでは、Background、 Foreground、 BorderBrush などのプロパティを設定する場合は、これらのリソースを変更することをお勧めします。 詳細については、XAML スタイルに関する記事の「軽量スタイル設定」セクションを参照してください。