VisualBrush.Visual プロパティ

リファレンス

定義

名前空間:: System.Windows.Media

アセンブリ:: PresentationCore.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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

プロパティ値

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 したり含めたりして、シーンを強制的に更新することができます。

注意

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

XAML プロパティ要素の使用

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

XAML 属性の使用方法

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

または

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

XAML 値

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

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

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

依存プロパティ情報


識別子フィールド	VisualProperty
に設定されたメタデータプロパティ `true`	なし

適用対象

次の方法で共有