VisualBrush クラス

定義

Visual で領域を塗りつぶします。Paints an area with a Visual.

public ref class VisualBrush sealed : System::Windows::Media::TileBrush
public sealed class VisualBrush : System.Windows.Media.TileBrush
type VisualBrush = class
    inherit TileBrush
Public NotInheritable Class VisualBrush
Inherits TileBrush
継承

注釈

Visualコンテンツを指定するには、 VisualBrush2 つの方法があります。There are two ways to specify the Visual content of a VisualBrush.

  • 新しいVisualを作成し、 VisualBrushそれを使用しVisualてのプロパティを設定します。Create a new Visual and use it to set the Visual property of the VisualBrush.

  • 既存Visualのを使用します。これにより、ターゲットVisualのイメージが複製されます。Use an existing Visual, which creates a duplicate image of the target Visual. その後、を使用VisualBrushして、反射や拡大などの興味深い効果を作成できます。You can then use the VisualBrush to create interesting effects, such as reflection and magnification.

UIElement ( Visual VisualBrush trueパネルやコントロールAutoLayoutContentなどVisual ) の新しいを定義すると、プロパティがに設定されている場合、とその子要素でレイアウトシステムが実行されます。UIElementWhen you define a new Visual for a VisualBrush and that Visual is a UIElement (such as a panel or control), the layout system runs on the UIElement and its child elements when the AutoLayoutContent property is set to true. ただし、ルートUIElementは基本的にシステムの他の部分から分離されています。スタイル、ストーリーボード、および外部レイアウトは、この境界をはことはできません。However, the root UIElement is essentially isolated from the rest of the system; styles, storyboards, and external layout can't permeate this boundary. したがって、ルートUIElementのサイズを明示的に指定する必要があります。これは、唯一のVisualBrush親がであるため、描画される領域に自動的にサイズを変更することはできないためです。Therefore, you should explicitly specify the size of the root UIElement, because its only parent is the VisualBrush and therefore it cannot automatically size itself to the area being painted. Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) でのレイアウトの詳細については、「レイアウト」を参照してください。For more information about layout in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), see the Layout.

がブラシの親チェーン内にVisualBrushある場合、のビジュアルツリーの更新は反映されません。 BitmapEffectUpdates to the visual tree of a VisualBrush will not propagate if a BitmapEffect is in the brush's parent chain. この制限を回避するには、効果の上にあるオブジェクトのシーンを強制的に更新します。You can workaround this limitation by forcing an update of the scene on the object above the effect. シーンの更新InvalidateVisualを強制するには、アニメーションを呼び出すか、含めることができます。You can call InvalidateVisual or include an animation to force a scene update.

Freezable 機能: クラスはFreezableクラスから継承するため、 VisualBrushクラスにはいくつかのVisualBrush特別な機能が用意されています。オブジェクトをとして宣言し、複数のオブジェクト間で共有することができます。Freezable Features: Because it inherits from the Freezable class, the VisualBrush class provides several special features: VisualBrush objects can be declared as and shared among multiple objects. オブジェクトによっFreezableて提供されるさまざまな機能の詳細については、「 Freezable オブジェクトの概要」を参照してください。For more information about the different features provided by Freezable objects, see the Freezable Objects Overview.

注意

プロパティが以外の値に設定されてVisualBrushいる場合、を読み取り専用 (固定) にすることはできません。 Visualnull.A VisualBrush cannot be made read-only (frozen) when its Visual property is set to any value other than null.

コンストラクター

VisualBrush()

VisualBrush クラスの新しいインスタンスを初期化します。Initializes a new instance of the VisualBrush class.

VisualBrush(Visual)

指定した Visual を格納している VisualBrush クラスの新しいインスタンスを初期化します。Initializes a new instance of the VisualBrush class that contains the specified Visual.

フィールド

AutoLayoutContentProperty

AutoLayoutContent 依存関係プロパティを識別します。Identifies the AutoLayoutContent dependency property.

VisualProperty

Visual 依存関係プロパティを識別します。Identifies the Visual dependency property.

プロパティ

AlignmentX

TileBrush 基本タイルのコンテンツの水平方向の配置を取得または設定します。Gets or sets the horizontal alignment of content in the TileBrush base tile.

(継承元 TileBrush)
AlignmentY

TileBrush 基本タイルのコンテンツの垂直方向の配置を取得または設定します。Gets or sets the vertical alignment of content in the TileBrush base tile.

(継承元 TileBrush)
AutoLayoutContent

この VisualBrush がその Visual のレイアウトを実行するかどうかを指定する値を取得または設定します。Gets or sets a value that specifies whether this VisualBrush will run layout its Visual.

CanFreeze

オブジェクトを変更不可能にできるかどうかを示す値を取得します。Gets a value that indicates whether the object can be made unmodifiable.

(継承元 Freezable)
DependencyObjectType

このインスタンスの CLRCLR 型をラップする DependencyObjectType を取得します。Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(継承元 DependencyObject)
Dispatcher

この Dispatcher が関連付けられている DispatcherObject を取得します。Gets the Dispatcher this DispatcherObject is associated with.

(継承元 DispatcherObject)
HasAnimatedProperties

1 つ以上の AnimationClock オブジェクトが、このオブジェクトの任意の依存関係プロパティに関連付けられているかどうかを示す値を取得または設定します。Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object's dependency properties.

(継承元 Animatable)
IsFrozen

オブジェクトが変更可能かどうかを示す値を取得します。Gets a value that indicates whether the object is currently modifiable.

(継承元 Freezable)
IsSealed

このインスタンスが現在シールされている (読み取り専用である) かどうかを示す値を取得します。Gets a value that indicates whether this instance is currently sealed (read-only).

(継承元 DependencyObject)
Opacity

Brush の不透明度を取得または設定します。Gets or sets the degree of opacity of a Brush.

(継承元 Brush)
RelativeTransform

相対座標を使用して、ブラシに適用される変換を取得または設定します。Gets or sets the transformation that is applied to the brush using relative coordinates.

(継承元 Brush)
Stretch

タイルに合わせてこの TileBrush のコンテンツを拡大する方法を指定する値を取得または設定します。Gets or sets a value that specifies how the content of this TileBrush stretches to fit its tiles.

(継承元 TileBrush)
TileMode

基本タイルが出力領域よりも小さい場合に TileBrush で領域を塗りつぶす方法を指定する値を取得または設定します。Gets or sets a value that specifies how a TileBrush fills the area that you are painting if the base tile is smaller than the output area.

(継承元 TileBrush)
Transform

ブラシに適用される変換を取得または設定します。Gets or sets the transformation that is applied to the brush. ブラシの出力をマップして配置した後に、この変換が適用されます。This transformation is applied after the brush's output has been mapped and positioned.

(継承元 Brush)
Viewbox

TileBrush タイル内のコンテンツの位置とサイズを取得または設定します。Gets or sets the position and dimensions of the content in a TileBrush tile.

(継承元 TileBrush)
ViewboxUnits

Viewbox の値が TileBrush コンテンツの境界ボックスに対して相対的か、または絶対的かどうかを指定する値を取得または設定します。Gets or sets a value that specifies whether the Viewbox value is relative to the bounding box of the TileBrush contents or whether the value is absolute.

(継承元 TileBrush)
Viewport

TileBrush の基本タイルの位置とサイズを取得または設定します。Gets or sets the position and dimensions of the base tile for a TileBrush.

(継承元 TileBrush)
ViewportUnits

BrushMappingMode 基本タイルのサイズと位置を示す Viewport の値が出力領域のサイズに対して相対的かどうかを指定する、TileBrush 列挙体を取得または設定します。Gets or sets a BrushMappingMode enumeration that specifies whether the value of the Viewport, which indicates the size and position of the TileBrush base tile, is relative to the size of the output area.

(継承元 TileBrush)
Visual

ブラシのコンテンツを取得または設定します。Gets or sets the brush's content.

メソッド

ApplyAnimationClock(DependencyProperty, AnimationClock)

AnimationClock を指定した DependencyProperty に適用します。Applies an AnimationClock to the specified DependencyProperty. プロパティが既にアニメーション化されている場合は、SnapshotAndReplace ハンドオフ動作が使用されます。If the property is already animated, the SnapshotAndReplace handoff behavior is used.

(継承元 Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

AnimationClock を指定した DependencyProperty に適用します。Applies an AnimationClock to the specified DependencyProperty. プロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。If the property is already animated, the specified HandoffBehavior is used.

(継承元 Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

指定された DependencyProperty にアニメーションを適用します。Applies an animation to the specified DependencyProperty. アニメーションは、次のフレームがレンダリングされるときに開始されます。The animation is started when the next frame is rendered. 指定されたプロパティが既にアニメーション化されている場合は、SnapshotAndReplace ハンドオフ動作が使用されます。If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

(継承元 Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

指定された DependencyProperty にアニメーションを適用します。Applies an animation to the specified DependencyProperty. アニメーションは、次のフレームがレンダリングされるときに開始されます。The animation is started when the next frame is rendered. 指定したプロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。If the specified property is already animated, the specified HandoffBehavior is used.

(継承元 Animatable)
CheckAccess()

呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。Determines whether the calling thread has access to this DispatcherObject.

(継承元 DispatcherObject)
ClearValue(DependencyProperty)

プロパティのローカル値をクリアします。Clears the local value of a property. クリアするプロパティは DependencyProperty 識別子で指定されます。The property to be cleared is specified by a DependencyProperty identifier.

(継承元 DependencyObject)
ClearValue(DependencyPropertyKey)

読み取り専用プロパティのローカル値を消去します。Clears the local value of a read-only property. 消去するプロパティは、DependencyPropertyKey で指定します。The property to be cleared is specified by a DependencyPropertyKey.

(継承元 DependencyObject)
Clone()

この VisualBrush の変更可能な複製を作成し、このオブジェクトの値の詳細コピーを作成します。Creates a modifiable clone of this VisualBrush, making deep copies of this object's values.

CloneCore(Freezable)

基本 (アニメーション化されていない) プロパティ値を使用して、インスタンスを、指定した Freezable の複製 (詳細コピー) にします。Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(継承元 Freezable)
CloneCurrentValue()

この VisualBrush オブジェクトの変更可能な複製を作成し、このオブジェクトの現在値の詳細コピーを作成します。Creates a modifiable clone of this VisualBrush object, making deep copies of this object's current values. リソース参照、データ バインディング、アニメーションはコピーされませんが、それらの現在値はコピーされます。Resource references, data bindings, and animations are not copied, but their current values are.

CloneCurrentValueCore(Freezable)

現在のプロパティ値を使用して、インスタンスを、指定した Freezable の変更可能な複製 (詳細コピー) にします。Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(継承元 Freezable)
CoerceValue(DependencyProperty)

指定した依存関係プロパティの値を強制します。Coerces the value of the specified dependency property. これは、呼び出し元の DependencyObject の依存関係プロパティのプロパティ メタデータで指定されている CoerceValueCallback 関数を呼び出すことによって実現されます。This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(継承元 DependencyObject)
CreateInstance()

Freezable クラスの新しいインスタンスを初期化します。Initializes a new instance of the Freezable class.

(継承元 Freezable)
CreateInstanceCore()

派生クラスで実装された場合、Freezable 派生クラスの新しいインスタンスを作成します。When implemented in a derived class, creates a new instance of the Freezable derived class.

(継承元 Freezable)
Equals(Object)

指定した DependencyObject が現在の DependencyObject と等しいかどうかを判断します。Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(継承元 DependencyObject)
Freeze()

現在のオブジェクトを変更不可能にし、その IsFrozen プロパティを true に設定します。Makes the current object unmodifiable and sets its IsFrozen property to true.

(継承元 Freezable)
FreezeCore(Boolean)

Animatable オブジェクトを変更不可能な状態にするか、変更不可能な状態にできるかどうかを判断します。Makes this Animatable object unmodifiable or determines whether it can be made unmodifiable.

(継承元 Animatable)
GetAnimationBaseValue(DependencyProperty)

指定した DependencyProperty のアニメーション化されていない値を返します。Returns the non-animated value of the specified DependencyProperty.

(継承元 Animatable)
GetAsFrozen()

基本プロパティ値 (アニメーション化されていない値) を使用して、Freezable の 固定されたコピーを作成します。Creates a frozen copy of the Freezable, using base (non-animated) property values. コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。Because the copy is frozen, any frozen sub-objects are copied by reference.

(継承元 Freezable)
GetAsFrozenCore(Freezable)

基本プロパティ値 (アニメーション化されていない値) を使用して、インスタンスを、指定した Freezable の固定された複製にします。Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(継承元 Freezable)
GetContentBounds(Rect)

TileBrush コンテンツの現在の境界を取得します。Obtains the current bounds of the TileBrush content.

(継承元 TileBrush)
GetCurrentValueAsFrozen()

現在のプロパティ値を使用して、Freezable の固定されたコピーを作成します。Creates a frozen copy of the Freezable using current property values. コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。Because the copy is frozen, any frozen sub-objects are copied by reference.

(継承元 Freezable)
GetCurrentValueAsFrozenCore(Freezable)

現在のインスタンスを、指定した Freezable の固定された複製にします。Makes the current instance a frozen clone of the specified Freezable. オブジェクトに、アニメーション化された依存関係プロパティが存在する場合、現在アニメーション化されている値がコピーされます。If the object has animated dependency properties, their current animated values are copied.

(継承元 Freezable)
GetHashCode()

この DependencyObject のハッシュ コードを取得します。Gets a hash code for this DependencyObject.

(継承元 DependencyObject)
GetLocalValueEnumerator()

どの依存関係プロパティがこの DependencyObject 上にローカルに設定された値を持つかを確認するための、専用の列挙子を作成します。Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(継承元 DependencyObject)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
GetValue(DependencyProperty)

DependencyObject のこのインスタンスにある依存関係プロパティの現在の有効値を返します。Returns the current effective value of a dependency property on this instance of a DependencyObject.

(継承元 DependencyObject)
InvalidateProperty(DependencyProperty)

指定した依存関係プロパティの有効値を再評価します。Re-evaluates the effective value for the specified dependency property.

(継承元 DependencyObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
OnChanged()

現在の Freezable オブジェクトの変更時に呼び出されます。Called when the current Freezable object is modified.

(継承元 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

設定されたばかりの DependencyObjectType データ メンバーに対して、適切なコンテキスト ポインターが確立されていることを確認します。Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(継承元 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

このメンバーは、Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) インフラストラクチャをサポートしますが、独自に作成したコードから直接使用するためのものではありません。This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(継承元 Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

OnPropertyChanged(DependencyPropertyChangedEventArgs)DependencyObject 実装をオーバーライドして、さらに型 Freezable の変化する依存関係プロパティへの応答として任意の Changed ハンドラーも呼び出します。Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(継承元 Freezable)
ReadLocalValue(DependencyProperty)

ローカルの依存関係プロパティの値を返します (存在する場合)。Returns the local value of a dependency property, if it exists.

(継承元 DependencyObject)
ReadPreamble()

Freezable が有効なスレッドからアクセスされていることを確認します。Ensures that the Freezable is being accessed from a valid thread. Freezable の継承側は、依存関係プロパティでないデータ メンバーを読み取る任意の API の開始時に、このメソッドを呼び出す必要があります。Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(継承元 Freezable)
SetCurrentValue(DependencyProperty, Object)

依存関係プロパティ値のソースを変更せずにその値を設定します。Sets the value of a dependency property without changing its value source.

(継承元 DependencyObject)
SetValue(DependencyProperty, Object)

依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。Sets the local value of a dependency property, specified by its dependency property identifier.

(継承元 DependencyObject)
SetValue(DependencyPropertyKey, Object)

依存関係プロパティの DependencyPropertyKey 識別子で指定した読み取り専用の依存関係プロパティのローカル値を設定します。Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(継承元 DependencyObject)
ShouldSerializeProperty(DependencyProperty)

シリアル化プロセスが、指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(継承元 DependencyObject)
ToString()

この Brush の文字列表現を返します。Return string representation of this Brush.

(継承元 Brush)
ToString(IFormatProvider)

指定したカルチャ固有の書式設定情報に基づいて、このオブジェクトの文字列表現を作成します。Creates a string representation of this object based on the specified culture-specific formatting information.

(継承元 Brush)
VerifyAccess()

呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。Enforces that the calling thread has access to this DispatcherObject.

(継承元 DispatcherObject)
WritePostscript()

FreezableChanged イベントを発生させ、その OnChanged() メソッドを呼び出します。Raises the Changed event for the Freezable and invokes its OnChanged() method. Freezable から派生するクラスは、依存関係プロパティとして格納されていないクラス メンバーを変更するすべての API の終了時に、このメソッドを呼び出す必要があります。Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(継承元 Freezable)
WritePreamble()

Freezable が固定されておらず、有効なスレッド コンテキストからアクセスされていることを確認します。Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Freezable の継承側は、依存関係プロパティでないデータ メンバーに書き込む任意の API の開始時に、このメソッドを呼び出す必要があります。Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(継承元 Freezable)

イベント

Changed

Freezable、またはこれに含まれているオブジェクトが変更されると発生します。Occurs when the Freezable or an object it contains is modified.

(継承元 Freezable)

明示的なインターフェイスの実装

IFormattable.ToString(String, IFormatProvider)

指定した書式を使用して、現在のインスタンスの値に書式を付けます。Formats the value of the current instance using the specified format.

(継承元 Brush)

適用対象

こちらもご覧ください