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 つのカテゴリは または ContainerVisualですUIElement。 UIElement には基本的に、WPF アプリケーションの UI に参加できる UI 要素が含まれます。 ContainerVisual には、 DrawingGroup 1 つ以上 Drawingの派生オブジェクトを含む が含まれます。

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

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

XAML プロパティ要素の使用

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

XAML 属性の使用方法

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

または

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

XAML 値

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

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

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

依存プロパティ情報

適用対象