Brush クラス

定義

名前空間:

Windows.UI.Xaml.Media

グラフィカル オブジェクトの塗りつぶしに使用するオブジェクトを定義します。 Brush から派生したクラスは、領域の描画方法を記述します。

public ref class Brush : DependencyObject, IAnimationObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Brush : DependencyObject, IAnimationObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Brush : DependencyObject, IAnimationObject

Public Class Brush
Inherits DependencyObject
Implements IAnimationObject

<object property="predefinedColorName"/>
- or -
<object property="#rgb"/>
- or -
<object property="#argb"/>
- or -
<object property="#rrggbb"/>
- or -
<object property="#aarrggbb"/>
- or -
<object property="sc#scR,scG,scB"/>
- or -
<object property="sc#scA,scR,scG,scB"/>

継承

Object Platform::Object IInspectable DependencyObject Brush

派生

Windows.UI.Xaml.Media.GradientBrush

Windows.UI.Xaml.Media.SolidColorBrush

Windows.UI.Xaml.Media.TileBrush

Windows.UI.Xaml.Media.XamlCompositionBrushBase

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装

IAnimationObject

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

Brush で表される UI 描画の概念の例と詳細については、「 ブラシを使用する」を参照してください。

XAML リソースとしてのブラシ

XAML で宣言できる各 Brush 型 (SolidColorBrush、 LinearGradientBrush、 ImageBrush) は、アプリ全体でそのブラシをリソースとして再利用できるように、リソースとして定義することを目的としています。 Brush 型に表示される XAML 構文は、ブラシをリソースとして定義する場合に適しています。 ブラシをリソースとして宣言する場合は、後で他の UI 定義からそのリソースを参照するために使用する x:Key 属性 も必要です。 XAML リソースの詳細と x:Key 属性の使用方法については、「 ResourceDictionary および XAML リソース参照」を参照してください。

ブラシをリソースとして宣言する利点は、UI を構築するために必要なランタイム オブジェクトの数を減らすことです。ブラシは、オブジェクト グラフの複数の部分に値を提供する共通リソースとして共有されるようになりました。

Windows ランタイム XAML コントロールの既存のコントロール テンプレート定義を見ると、テンプレートでブラシ リソースが広範囲に使用されていることがわかります。 これらのリソースの多くはシステム リソースであり、 {StaticResource} マークアップ拡張機能 ではなく、リソース参照に {ThemeResource} マークアップ拡張機能を使用します。 独自のコントロール テンプレート XAML でシステム リソース ブラシを使用する方法の詳細については、「 XAML テーマ リソース」を参照してください。

ブラシ 派生クラス

Brush は、UI 領域を描画する実用的なブラシを実装する、またはそのようなブラシの中間基底クラスである、いくつかの派生クラスの親クラスです。

• GradientBrush: LinearGradientBrush の中間基本クラス。
• SolidColorBrush: これは最も一般的に使用されるブラシです。
• TileBrush: ImageBrush の中間基本クラス。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1809	17763	PopulatePropertyInfo
1809	17763	PopulatePropertyInfoOverride

コンストラクター

Brush()

Brush 派生クラスの基本クラス初期化動作を提供します。

プロパティ

Dispatcher	このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject)
Opacity	ブラシの不透明度を取得または設定 します。
OpacityProperty	Opacity 依存関係プロパティを識別します。
RelativeTransform	相対座標を使用して、ブラシに適用される変換を取得または設定します。
RelativeTransformProperty	RelativeTransform 依存関係プロパティを識別します。
Transform	ブラシに適用される変換を取得または設定します。
TransformProperty	Transform 依存関係プロパティを識別します。

メソッド

ClearValue(DependencyProperty)	依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。 (継承元 DependencyObject)
GetValue(DependencyProperty)	DependencyObject から依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	アニメーション化できるプロパティを定義します。
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	派生クラスでオーバーライドされると、アニメーション化できるプロパティを定義します。
ReadLocalValue(DependencyProperty)	ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。 (継承元 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	この DependencyObject インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。 (継承元 DependencyObject)

こちらもご覧ください

• DependencyObject
• SolidColorBrush
• Color
• Colors
• ブラシの使用
• Image と ImageBrush
• ResourceDictionary と XAML リソースの参照