VisualBrush.Visual プロパティ

定義

名前空間:

System.Windows.Media

アセンブリ:

PresentationCore.dll

ブラシのコンテンツを取得または設定します。

C#

public System.Windows.Media.Visual Visual { get; set; }

プロパティ値

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 を呼び出したり、アニメーションを含めたりして、シーンの更新を強制することができます。

注意

Visual プロパティが null以外の値に設定されている場合、VisualBrush を読み取り専用 (固定) にすることはできません。

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

XAML

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

XAML 属性の使用法

< オブジェクトVisual="{bindingExpression}"/>

-又は-

< オブジェクトVisual="{resourceExpression}"/>

XAML 値

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

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

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

依存関係プロパティ情報

識別子フィールド	VisualProperty
true に設定されたメタデータ プロパティ	何一つ

適用対象