VisualBrush.Visual プロパティ

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

プロパティ値

ブラシの内容。 既定値は、null です。

注釈

VisualBrushのVisualコンテンツを指定するには、2 つの方法があります。

• 新しいVisualを作成し、それを使用してVisualBrushのVisual プロパティを設定します。

• 既存の Visualを使用して、ターゲット Visualの重複するイメージを作成します。 その後、 VisualBrush を使用して、反射や倍率などの興味深い効果を作成できます。

Visual は WPF クラス階層全体で非常に高いため、非常に多くのオブジェクトが VisualBrushに使用するビジュアルとして機能する可能性があります。リスト全体をここに表示することはできません。 「 Visual」を参照してください。「継承階層」セクションを参照してください。このセクションには、すぐに派生したクラスが表示されます。 その後、すぐに派生したクラスをクリックし、階層を走査して、さまざまな可能性を把握できます。 最上位レベルでは、 VisualBrush に使用できるオブジェクトの最も一般的な 2 つのカテゴリは、 UIElement または ContainerVisualです。 UIElement には基本的に、WPF アプリケーションの UI に参加できる UI 要素が含まれます。 ContainerVisualには、1 つ以上のDrawing派生オブジェクトを含むDrawingGroupが含まれています。

VisualBrushの新しいVisualを定義し、そのVisualがUIElement (パネルやコントロールなど) である場合、AutoLayoutContent プロパティがtrueに設定されている場合、レイアウト システムはUIElementとその子要素で実行されます。 ただし、ルート UIElement は基本的にシステムの残りの部分から分離されています。ブラシが適用されている親によって指示されたスタイル、ストーリーボード、および外部レイアウトは、この境界に浸透できません。 したがって、ルート UIElementのサイズを明示的に指定する必要があります。その唯一の親は VisualBrush であるため、塗りつぶされている領域に自動的にサイズを設定することはできません。 Windows Presentation Foundation (WPF) のレイアウトの詳細については、「 レイアウト」を参照してください。

BitmapEffectがブラシの親チェーンにある場合、VisualBrushのビジュアル ツリーの更新は反映されません。 この制限を回避するには、効果の上にあるオブジェクトに対してシーンの更新を強制します。 InvalidateVisualを呼び出したり、アニメーションを含めたりして、シーンの更新を強制することができます。

XAML プロパティ要素の使用法

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

XAML 属性の使用法

< objectVisual="{bindingExpression}"/>

-又は-

< objectVisual="{resourceExpression}"/>

XAML 値

singleVisualRoot ブラシの新しいビジュアル要素を定義する 1 つのオブジェクト要素。 これは、 Visualから派生するオブジェクトである必要があります。 「解説」を参照してください。

bindingExpression 既存の Visual インスタンスに評価される式。

resourceExpression既存のVisual インスタンスに評価されるStaticResourceまたはDynamicResource。 「XAML リソース」を参照してください。

依存関係プロパティ情報