VisualBrush.Visual VisualBrush.Visual VisualBrush.Visual VisualBrush.Visual Property

定義

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

public:
 property System::Windows::Media::Visual ^ Visual { System::Windows::Media::Visual ^ get(); void set(System::Windows::Media::Visual ^ value); };
public System.Windows.Media.Visual Visual { get; set; }
member this.Visual : System.Windows.Media.Visual with get, set
Public Property Visual As Visual

プロパティ値

ブラシのコンテンツ。The brush's content. 既定値は、null です。The default is null.

注釈

2 つの方法を指定する、VisualのコンテンツをVisualBrushします。There are two ways to specify the Visual content of a VisualBrush.

  • 新規作成Visualに設定して、Visualのプロパティ、VisualBrushします。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.

Visual 非常に多数のオブジェクトを使用するビジュアルとして使用可能性があるために、WPF クラス階層全体でかなり上位には、 VisualBrush; リスト全体をここで示すことはできません。Visual is quite high in the overall WPF class hierarchy, so a very large number of objects could possibly serve as the visual that you use for a VisualBrush; the entire list cannot be shown here. 参照してくださいVisual。 すぐに派生クラスが表示されます"継承階層"セクションを参照してください。See Visual; refer to the "Inheritance Hierarchy" section, which will show the immediately derived classes. すぐに派生クラスをクリックし、あらゆる可能性を把握する階層を走査できます。You can then click on the immediately derived classes and traverse the hierarchies to get a sense of the full range of possibilities. 最上位には、オブジェクトの 2 つの最も一般的なカテゴリがありますを使用する、VisualBrushUIElementまたはContainerVisualします。At a top level, the two most common categories of objects you might use for a VisualBrush are UIElement or ContainerVisual. UIElement 基本的に任意の UI 要素の WPF アプリケーションの UI に参加できるそれ以外の場合に相当します。UIElement encompasses basically any UI element that can otherwise participate in the UI for a WPF application. ContainerVisual 含まれています、DrawingGroupを含む 1 つまたは複数Drawingの派生オブジェクト。ContainerVisual contains a DrawingGroup that includes one or more Drawing-derived objects.

新しいを定義するときVisualVisualBrushVisualは、 UIElement (パネルやコントロール) など、レイアウト システムがで実行、UIElementとその子要素と、AutoLayoutContentプロパティに設定されてtrueWhen 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 dictated by the parent where the brush is applied cannot 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場合に伝達されません、BitmapEffectブラシの親チェーンにします。Updates 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シーンの update を強制するアニメーションが含まれますか。You can call InvalidateVisual or include an animation to force a scene update.

注意

AVisualBrushにできない読み取り専用と (固定) そのVisualプロパティが以外の任意の値に設定されて null.A VisualBrush cannot be made read-only (frozen) when its Visual property is set to any value other than null.

XAML プロパティ要素の使用XAML Property Element Usage

<object>  
  <object.Visual>  
    singleVisualRoot  
  </object.Visual>  
</object>  

XAML 属性の使用方法XAML Attribute Usage

<object Visual="{bindingExpression}"/><object Visual="{bindingExpression}"/>

または-or-

<object Visual="{resourceExpression}"/><object Visual="{resourceExpression}"/>

XAML 値XAML Values

singleVisualRoot
ブラシの場合は、新しいビジュアル要素を定義する 1 つのオブジェクトの要素。A single object element that defines a new visual element for the brush. これから派生したオブジェクトである必要がありますVisualします。This must be an object that derives from Visual. 「解説」を参照してください。See Remarks.

bindingExpression
既存に評価される AVisualインスタンス。A that evaluates to an existing Visual instance.

resourceExpression
AStaticResourceまたはDynamicResource既存に評価されるVisualインスタンス。A StaticResource or DynamicResource that evaluates to an existing Visual instance. 参照してくださいXAML リソースSee XAML Resources

依存プロパティ情報Dependency Property Information

識別子フィールドです。Identifier field VisualProperty
メタデータのプロパティを設定するには trueMetadata properties set to true なしNone

適用対象