エクスポート (0) 印刷
すべて展開
この記事は機械翻訳されたものです。 記事の文章にポインターを重ねると、原文のテキストが表示されます。 詳細情報
訳文
原文

Brush クラス

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

名前空間:  System.Windows.Media
アセンブリ:  PresentationCore (PresentationCore.dll 内)
XAML の XMLNS : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
[TypeConverterAttribute(typeof(BrushConverter))]
public abstract class Brush : Animatable, 
	IFormattable
XAML については、「解説」を参照してください。

Brush 型で公開されるメンバーは以下のとおりです。

  名前説明
プロテクト メソッドBrush Brush クラスの新しいインスタンスを初期化します。
このページのトップへ

  名前説明
パブリック プロパティCanFreezeオブジェクトを変更不可能な状態にできるかどうかを示す値を取得します。 (Freezable から継承されます。)
パブリック プロパティDependencyObjectTypeこのインスタンスの CLR 型をラップする DependencyObjectType を取得します。  (DependencyObject から継承されます。)
パブリック プロパティDispatcherこの DispatcherObject が関連付けられている Dispatcher を取得します。 (DispatcherObject から継承されます。)
パブリック プロパティDispatcher (DependencyObject から継承されます。)
パブリック プロパティHasAnimatedProperties1 つ以上の AnimationClock オブジェクトが、このオブジェクトの任意の依存関係プロパティに関連付けられているかどうかを示す値を取得または設定します。 (Animatable から継承されます。)
パブリック プロパティIsFrozen現在このオブジェクトが変更可能な状態であるかどうかを示す値を取得します。 (Freezable から継承されます。)
パブリック プロパティIsSealedこのインスタンスが現在シールされている (読み取り専用である) かどうかを示す値を取得します。 (DependencyObject から継承されます。)
パブリック プロパティOpacity Brush の不透明度を取得または設定します。
パブリック プロパティRelativeTransformブラシに適用される相対座標を使用した変換を取得または設定します。
パブリック プロパティTransformブラシに適用される変換を取得または設定します。 この変換は、ブラシの出力がマップされて配置された後に適用されます。
このページのトップへ

  名前説明
パブリック メソッドApplyAnimationClock(DependencyProperty, AnimationClock) AnimationClock を指定した DependencyProperty に適用します。 プロパティが既にアニメーション化されている場合は、SnapshotAndReplace ハンドオフ動作が使用されます。 (Animatable から継承されます。)
パブリック メソッドApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) AnimationClock を指定した DependencyProperty に適用します。 プロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (Animatable から継承されます。)
パブリック メソッドBeginAnimation(DependencyProperty, AnimationTimeline)指定した DependencyProperty にアニメーションを適用します。 次のフレームが描画されると、アニメーションが開始されます。 指定したプロパティが既にアニメーション化されている場合は、SnapshotAndReplace ハンドオフ動作が使用されます。 (Animatable から継承されます。)
パブリック メソッドBeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)指定した DependencyProperty にアニメーションを適用します。 次のフレームが描画されると、アニメーションが開始されます。 指定したプロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (Animatable から継承されます。)
パブリック メソッドCheckAccess呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。 (DispatcherObject から継承されます。)
パブリック メソッドClearValue(DependencyProperty)プロパティのローカル値を消去します。 消去するプロパティは、DependencyProperty 識別子で指定します。 (DependencyObject から継承されます。)
パブリック メソッドClearValue(DependencyPropertyKey)読み取り専用プロパティのローカル値を消去します。 消去するプロパティは、DependencyPropertyKey で指定します。 (DependencyObject から継承されます。)
パブリック メソッドCloneこの Brush の変更可能な複製を作成し、このオブジェクトの値の詳細コピーを作成します。 このメソッドは、依存関係プロパティをコピーするときに、リソースの参照とデータ バインディングをコピーしますが (ただし、これらは解決されなくなっている場合があります)、アニメーションやその現在の値はコピーしません。
プロテクト メソッドCloneCore基本プロパティ値 (アニメーション化されていない値) を使用して、インスタンスを、指定した Freezable の複製 (詳細コピー) にします。 (Freezable から継承されます。)
パブリック メソッドCloneCurrentValueこの Brush オブジェクトの変更可能な複製を作成し、このオブジェクトの現在値の詳細コピーを作成します。 リソース参照、データ バインディング、アニメーションはコピーされませんが、それらの現在値はコピーされます。
プロテクト メソッドCloneCurrentValueCoreプロパティの現在の値を使用して、インスタンスを、指定した Freezable の変更可能な複製 (詳細コピー) にします。 (Freezable から継承されます。)
パブリック メソッドCoerceValue指定した依存関係プロパティの値を強制します。 これは、呼び出し元の DependencyObject の依存関係プロパティのプロパティ メタデータで指定されている CoerceValueCallback 関数を呼び出すことによって実現されます。 (DependencyObject から継承されます。)
プロテクト メソッドCreateInstance Freezable クラスの新しいインスタンスを初期化します。 (Freezable から継承されます。)
プロテクト メソッドCreateInstanceCore派生クラスで実装された場合、Freezable 派生クラスの新しいインスタンスを作成します。 (Freezable から継承されます。)
パブリック メソッドEquals指定した DependencyObject が現在の DependencyObject と等しいかどうかを判断します。 (DependencyObject から継承されます。)
プロテクト メソッドFinalize オブジェクトがガベジ コレクションにより収集される前に、そのオブジェクトがリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
パブリック メソッドFreeze()現在のオブジェクトを変更不可能な状態にして、その IsFrozen プロパティを true に設定します。 (Freezable から継承されます。)
プロテクト メソッドFreezeCore Animatable オブジェクトを変更不可能な状態にするか、変更不可能な状態にできるかどうかを判断します。 (Animatable から継承されます。)
パブリック メソッドGetAnimationBaseValue指定した DependencyProperty のアニメーション化されていない値を返します。 (Animatable から継承されます。)
パブリック メソッドGetAsFrozen基本プロパティ値 (アニメーション化されていない値) を使用して、Freezable の 固定されたコピーを作成します。 コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。 (Freezable から継承されます。)
プロテクト メソッドGetAsFrozenCore基本プロパティ値 (アニメーション化されていない値) を使用して、インスタンスを、指定した Freezable の固定された複製にします。 (Freezable から継承されます。)
パブリック メソッドGetCurrentValueAsFrozen現在のプロパティ値を使用して、Freezable の固定されたコピーを作成します。 コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。 (Freezable から継承されます。)
プロテクト メソッドGetCurrentValueAsFrozenCore現在のインスタンスを、指定した Freezable の固定された複製にします。 オブジェクトに、アニメーション化された依存関係プロパティが存在する場合、現在アニメーション化されている値がコピーされます。 (Freezable から継承されます。)
パブリック メソッドGetHashCodeこの DependencyObject のハッシュ コードを取得します。 (DependencyObject から継承されます。)
パブリック メソッドGetLocalValueEnumeratorどの依存関係プロパティがこの DependencyObject 上にローカルに設定された値を持つかを確認するための、専用の列挙子を作成します。 (DependencyObject から継承されます。)
パブリック メソッドGetType現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッドGetValue DependencyObject のこのインスタンスにある依存関係プロパティの現在の有効値を返します。 (DependencyObject から継承されます。)
パブリック メソッドInvalidateProperty指定した依存関係プロパティの有効値を再評価します。 (DependencyObject から継承されます。)
プロテクト メソッドMemberwiseClone現在の Object の簡易コピーを作成します。 (Object から継承されます。)
プロテクト メソッドOnChanged現在の Freezable オブジェクトが変更されると呼び出されます。 (Freezable から継承されます。)
プロテクト メソッドOnFreezablePropertyChanged(DependencyObject, DependencyObject)設定されたばかりの DependencyObjectType データ メンバーに対して、適切なコンテキスト ポインターが確立されていることを確認します。 (Freezable から継承されます。)
プロテクト メソッドOnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートします。コードから直接使用するためのものではありません。 (Freezable から継承されます。)
プロテクト メソッドOnPropertyChanged DependencyObject OnPropertyChanged 実装をオーバーライドして、Freezable 型の依存関係プロパティの変更に応答して任意の Changed ハンドラーも呼び出されるようにします。 (Freezable から継承されます。)
パブリック メソッドReadLocalValue依存関係プロパティのローカル値が存在する場合に、そのローカル値を返します。 (DependencyObject から継承されます。)
プロテクト メソッドReadPreamble Freezable が有効なスレッドからアクセスされていることを確認します。 Freezable の継承側は、依存関係プロパティでないデータ メンバーを読み取る任意の API の開始時に、このメソッドを呼び出す必要があります。 (Freezable から継承されます。)
パブリック メソッドSetCurrentValue依存関係プロパティ値のソースを変更せずにその値を設定します。 (DependencyObject から継承されます。)
パブリック メソッドSetValue(DependencyProperty, Object)依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。 (DependencyObject から継承されます。)
パブリック メソッドSetValue(DependencyPropertyKey, Object)読み取り専用の依存関係プロパティの DependencyPropertyKey 識別子を指定して、該当する依存関係プロパティのローカル値を設定します。 (DependencyObject から継承されます。)
プロテクト メソッドShouldSerializePropertyシリアル化プロセスが、指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。 (DependencyObject から継承されます。)
パブリック メソッドToString() この Brush の文字列表現を返します。 (Object.ToString() をオーバーライドします。)
パブリック メソッドToString(IFormatProvider) 指定したカルチャ固有の書式設定情報に基づいて、このオブジェクトの文字列表現を作成します。
パブリック メソッドVerifyAccess呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。 (DispatcherObject から継承されます。)
プロテクト メソッドWritePostscript Freezable Changed イベントを発生させ、その OnChanged メソッドを呼び出します。 Freezable から派生するクラスは、依存関係プロパティとして格納されていないクラス メンバーを変更する任意の API の終了時に、このメソッドを呼び出す必要があります。 (Freezable から継承されます。)
プロテクト メソッドWritePreamble Freezable が固定されておらず、有効なスレッド コンテキストからアクセスされていることを確認します。 Freezable の継承側は、依存関係プロパティでないデータ メンバーに書き込む任意の API の開始時に、このメソッドを呼び出す必要があります。 (Freezable から継承されます。)
このページのトップへ

  名前説明
パブリック イベントChanged Freezable 、またはこれに含まれているオブジェクトが変更されると発生します。 (Freezable から継承されます。)
このページのトップへ

  名前説明
パブリック フィールド静的メンバーOpacityProperty Opacity  依存関係プロパティを識別します。
パブリック フィールド静的メンバーRelativeTransformProperty RelativeTransform  依存関係プロパティを識別します。
パブリック フィールド静的メンバーTransformProperty Transform  依存関係プロパティを識別します。
このページのトップへ

  名前説明
明示的なインターフェイス実装プライベート メソッドIFormattable.ToString指定した書式を使用して、現在のインスタンスの値に書式を付けます。
このページのトップへ

Brush は、その出力で領域を塗りつぶします。 ブラシによって出力の種類がそれぞれ異なります。 純色で領域を塗りつぶすブラシもあれば、グラデーション、パターン、イメージ、または描画で塗りつぶすブラシもあります。 WPF のブラシのさまざまな種類を次の一覧に示します。

  • SolidColorBrush : 領域を均一の Color (純色) で塗りつぶします。

  • LinearGradientBrush : 線形グラデーションで領域を塗りつぶします。

  • RadialGradientBrush : 放射状グラデーションで領域を塗りつぶします。

  • ImageBrush : イメージで領域を塗りつぶします。このイメージは ImageSource オブジェクトで表されます。

  • DrawingBrush : Drawing で領域を塗りつぶします。 描画には、ベクターとビットマップ オブジェクトを含めることができます。

  • VisualBrush : Visual オブジェクトで領域を塗りつぶします。 VisualBrush を使用すると、アプリケーションのある部分の内容を別の領域に複製できます。これは、反射効果を作成し、画面の一部を際立たせる場合に非常に役立ちます。

定義済みのブラシ

Brushes クラスを使用して、AliceBlueRed などの定義済みの純色でオブジェクトを塗りつぶします。

XAML のブラシ

XAML で使用できる各種の Brush とサポートされる構文を次の表に示します。 各ブラシでサポートされる構文の詳細については、そのブラシの説明ページを参照してください。

class

属性構文

オブジェクト要素の構文

SolidColorBrush

[はい]

[はい]

DrawingBrush

x

[はい]

ImageBrush

x

[はい]

LinearGradientBrush

x

[はい]

RadialGradientBrush

x

[はい]

VisualBrush

x

[はい]

純色で領域をすばやく塗りつぶす方法の例については、「方法 : 純色で領域を塗りつぶす」を参照してください。

Freezable の機能

ブラシは Freezable オブジェクトの一種です。 固定や複製など、Freezable 機能の詳細については、「Freezable オブジェクトの概要」を参照してください。

継承時の注意

Brush クラスから継承する場合は、CreateInstanceCore メソッドをオーバーライドする必要があります。 クラスで追加の初期化処理を実行したり、依存関係プロパティ以外のデータ メンバーを含めたりする必要があるかどうかによりますが、Freezable の他のメソッドをオーバーライドすることが必要になる場合があります。 Freezable 型から継承する方法の詳細については、「Freezable オブジェクトの概要」を参照してください。

.NET Framework

サポート対象 : 4.5.2、4.5.1、4.5、4、3.5、3.0

.NET Framework Client Profile

サポート対象 : 4、3.5 SP1

Windows Phone アプリ用 .NET

サポート対象 : Windows Phone 8、Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (サーバー コア ロールはサポート対象外), Windows Server 2008 R2 (SP1 以降でサーバー コア ロールをサポート。Itanium はサポート対象外)

.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

この型のすべてのパブリック static (Visual Basic では Shared) メンバーは、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

コミュニティの追加

追加
表示:
© 2014 Microsoft