Brush クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
グラフィカル オブジェクトの描画に使用するオブジェクトを定義します。 Brushから派生するクラスは、領域の描画方法を記述します。
public ref class Brush abstract : System::Windows::Media::Animation::Animatable, IFormattable[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public abstract class Brush : System.Windows.Media.Animation.Animatable, IFormattable[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Brush = class
inherit Animatable
interface IFormattable
interface DUCE.IResource[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Brush = class
inherit Animatable
interface IFormattablePublic MustInherit Class Brush
Inherits Animatable
Implements IFormattable- 継承
- 派生
- 属性
- 実装
注釈
Brushは、領域をその出力で "塗りつぶす" または "塗りつぶし" します。 ブラシによって出力の種類が異なります。 一部のブラシは、単色で領域を塗りつぶし、他のブラシはグラデーション、パターン、画像、または描画で塗りつぶします。 次の一覧では、さまざまな種類の WPF ブラシについて説明します。
SolidColorBrush:ソリッド Colorで領域を塗りつぶします。
LinearGradientBrush:直線状のグラデーションで領域を塗りつぶします。
RadialGradientBrush:放射状グラデーションで領域を塗りつぶします。
ImageBrush: 領域をイメージ ( ImageSource オブジェクトで表される) で塗りつぶします。
DrawingBrush:領域を Drawingで塗りつぶします。 描画には、ベクター オブジェクトとビットマップ オブジェクトを含めることができます。
VisualBrush: Visual オブジェクトを使用して領域を塗りつぶします。 VisualBrushを使用すると、アプリケーションのある部分から別の領域にコンテンツを複製できます。画面の反射効果と拡大部分を作成する場合に非常に便利です。
定義済みのブラシ
AliceBlueやRedなど、定義済みの純色を使用してオブジェクトを描画するには、Brushes クラスを使用します。
XAML のブラシ
次の表に、XAML で使用できるさまざまな Brush 型と、それらがサポートする構文を示します。 特定のブラシの構文の詳細については、そのブラシの種類ページを参照してください。
| クラス | 属性の構文 | オブジェクト要素の構文 |
|---|---|---|
| SolidColorBrush | はい | はい |
| DrawingBrush | いいえ | はい |
| ImageBrush | いいえ | はい |
| LinearGradientBrush | いいえ | はい |
| RadialGradientBrush | いいえ | はい |
| VisualBrush | いいえ | はい |
単色で領域をすばやく塗りつぶす方法を示す例については、「 方法: 単色で領域を塗りつぶす」を参照してください。
Freezable の機能
ブラシは、 Freezable オブジェクトの一種です。 フリーズや複製などの Freezable 機能の詳細については、「 Freezable オブジェクトの概要」を参照してください。
XAML テキストの使用法
XAML の詳細については、「解説」セクション を 参照してください。
注意 (実装者)
Brush クラスから継承する場合は、CreateInstanceCore() メソッドをオーバーライドする必要があります。 クラスで追加の初期化作業を実行する必要があるか、依存関係プロパティ以外のデータ メンバーが含まれているかに応じて、追加の Freezable メソッドをオーバーライドすることが必要になる場合があります。 Freezable型からの継承の詳細については、「Freezable オブジェクトの概要」を参照してください。
コンストラクター
| 名前 | 説明 |
|---|---|
| Brush() |
Brush クラスの新しいインスタンスを初期化します。 |
フィールド
| 名前 | 説明 |
|---|---|
| OpacityProperty |
Opacity依存関係プロパティを識別します。 |
| RelativeTransformProperty |
RelativeTransform依存関係プロパティを識別します。 |
| TransformProperty |
Transform依存関係プロパティを識別します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| CanFreeze |
オブジェクトを変更不可にできるかどうかを示す値を取得します。 (継承元 Freezable) |
| DependencyObjectType |
このインスタンスの CLR 型をラップする DependencyObjectType を取得します。 (継承元 DependencyObject) |
| Dispatcher |
このDispatcherが関連付けられているDispatcherObjectを取得します。 (継承元 DispatcherObject) |
| HasAnimatedProperties |
1 つ以上の AnimationClock オブジェクトがこのオブジェクトの依存関係プロパティのいずれかに関連付けられているかどうかを示す値を取得します。 (継承元 Animatable) |
| IsFrozen |
オブジェクトが現在変更可能かどうかを示す値を取得します。 (継承元 Freezable) |
| IsSealed |
このインスタンスが現在シールされているかどうかを示す値を取得します (読み取り専用)。 (継承元 DependencyObject) |
| Opacity |
Brushの不透明度を取得または設定します。 |
| RelativeTransform |
相対座標を使用してブラシに適用される変換を取得または設定します。 |
| Transform |
ブラシに適用される変換を取得または設定します。 この変換は、ブラシの出力がマップされ、配置された後に適用されます。 |
メソッド
| 名前 | 説明 |
|---|---|
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
指定したAnimationClockにDependencyPropertyを適用します。 プロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (継承元 Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
指定したAnimationClockにDependencyPropertyを適用します。 プロパティが既にアニメーション化されている場合は、 SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
指定した DependencyPropertyにアニメーションを適用します。 アニメーションは、次のフレームがレンダリングされるときに開始されます。 指定したプロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (継承元 Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
指定した DependencyPropertyにアニメーションを適用します。 アニメーションは、次のフレームがレンダリングされるときに開始されます。 指定したプロパティが既にアニメーション化されている場合は、 SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable) |
| CheckAccess() |
呼び出し元のスレッドがこの DispatcherObjectにアクセスできるかどうかを判断します。 (継承元 DispatcherObject) |
| ClearValue(DependencyProperty) |
プロパティのローカル値をクリアします。 クリアするプロパティは、 DependencyProperty 識別子によって指定されます。 (継承元 DependencyObject) |
| ClearValue(DependencyPropertyKey) |
読み取り専用プロパティのローカル値をクリアします。 クリアするプロパティは、 DependencyPropertyKeyによって指定されます。 (継承元 DependencyObject) |
| Clone() |
この Brushの変更可能な複製を作成し、このオブジェクトの値の詳細コピーを作成します。 依存関係プロパティをコピーする場合、このメソッドはリソース参照とデータ バインディングをコピーします (ただし、解決されなくなる可能性があります)、アニメーションやその現在の値はコピーしません。 |
| CloneCore(Freezable) |
基本 (アニメーション化されていない) プロパティ値を使用して、インスタンスを指定した Freezable の複製 (ディープ コピー) にします。 (継承元 Freezable) |
| CloneCurrentValue() |
この Brush オブジェクトの変更可能な複製を作成し、このオブジェクトの現在の値の詳細コピーを作成します。 リソース参照、データ バインディング、およびアニメーションはコピーされませんが、現在の値はコピーされます。 |
| CloneCurrentValueCore(Freezable) |
現在のプロパティ値を使用して、インスタンスを指定した Freezable の変更可能な複製 (ディープ コピー) にします。 (継承元 Freezable) |
| CoerceValue(DependencyProperty) |
指定した依存関係プロパティの値を強制します。 これは、呼び出し元のCoerceValueCallbackに存在する依存関係プロパティのプロパティ メタデータで指定されたDependencyObject関数を呼び出すことによって実現されます。 (継承元 DependencyObject) |
| CreateInstance() |
Freezable クラスの新しいインスタンスを初期化します。 (継承元 Freezable) |
| CreateInstanceCore() |
派生クラスで実装された場合は、 Freezable 派生クラスの新しいインスタンスを作成します。 (継承元 Freezable) |
| Equals(Object) |
指定された DependencyObject が現在の DependencyObjectと等しいかどうかを判断します。 (継承元 DependencyObject) |
| Freeze() |
現在のオブジェクトを変更不可にし、その IsFrozen プロパティを |
| FreezeCore(Boolean) |
この Animatable オブジェクトを変更不可にするか、変更不可にできるかどうかを判断します。 (継承元 Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
指定した DependencyPropertyのアニメーション化されていない値を返します。 (継承元 Animatable) |
| GetAsFrozen() |
基本 (アニメーション化されていない) プロパティ値を使用して、 Freezableの固定コピーを作成します。 コピーは固定されているため、固定されたサブオブジェクトは参照によってコピーされます。 (継承元 Freezable) |
| GetAsFrozenCore(Freezable) |
基本 (アニメーション化されていない) プロパティ値を使用して、インスタンスを指定した Freezable の固定複製にします。 (継承元 Freezable) |
| GetCurrentValueAsFrozen() |
現在のプロパティ値を使用して、 Freezable の固定コピーを作成します。 コピーは固定されているため、固定されたサブオブジェクトは参照によってコピーされます。 (継承元 Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
現在のインスタンスを、指定した Freezableの固定複製にします。 オブジェクトにアニメーション化された依存関係プロパティがある場合は、現在のアニメーション化された値がコピーされます。 (継承元 Freezable) |
| GetHashCode() |
この DependencyObjectのハッシュ コードを取得します。 (継承元 DependencyObject) |
| GetLocalValueEnumerator() |
この DependencyObjectでローカルに値が設定されている依存関係プロパティを決定するための特殊な列挙子を作成します。 (継承元 DependencyObject) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| GetValue(DependencyProperty) |
DependencyObjectのこのインスタンスの依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject) |
| InvalidateProperty(DependencyProperty) |
指定した依存関係プロパティの有効な値を再評価します。 (継承元 DependencyObject) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| OnChanged() |
現在の Freezable オブジェクトが変更されたときに呼び出されます。 (継承元 Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
設定したばかりの DependencyObjectType データ メンバーに対して適切なコンテキスト ポインターが確立されるようにします。 (継承元 Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
DependencyObjectのOnPropertyChanged(DependencyPropertyChangedEventArgs)実装をオーバーライドして、Changed型の依存関係プロパティの変化に応じてFreezable ハンドラーも呼び出します。 (継承元 Freezable) |
| ReadLocalValue(DependencyProperty) |
依存関係プロパティが存在する場合は、そのローカル値を返します。 (継承元 DependencyObject) |
| ReadPreamble() |
Freezableが有効なスレッドからアクセスされていることを確認します。 Freezableの継承子は、依存関係プロパティではないデータ メンバーを読み取る API の先頭でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
値ソースを変更せずに依存関係プロパティの値を設定します。 (継承元 DependencyObject) |
| SetValue(DependencyProperty, Object) |
依存関係プロパティ識別子で指定された依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
依存関係プロパティの DependencyPropertyKey 識別子で指定された、読み取り専用の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
シリアル化プロセスが指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。 (継承元 DependencyObject) |
| ToString() |
この Brushの文字列形式を返します。 |
| ToString(IFormatProvider) |
指定したカルチャ固有の書式設定情報に基づいて、このオブジェクトの文字列形式を作成します。 |
| VerifyAccess() |
呼び出し元のスレッドがこの DispatcherObjectにアクセスできるように強制します。 (継承元 DispatcherObject) |
| WritePostscript() |
ChangedのFreezable イベントを発生させ、そのOnChanged() メソッドを呼び出します。 Freezableから派生するクラスは、依存関係プロパティとして格納されていないクラス メンバーを変更する API の末尾でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
| WritePreamble() |
Freezableが固定されていないこと、および有効なスレッド コンテキストからアクセスされていることを確認します。 Freezable 継承子は、依存関係プロパティではないデータ メンバーに書き込む API の先頭でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
イベント
| 名前 | 説明 |
|---|---|
| Changed |
Freezableまたはそれに含まれるオブジェクトが変更されたときに発生します。 (継承元 Freezable) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
指定した形式を使用して、現在のインスタンスの値を書式設定します。 |
