VisualBrush.Visual プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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
プロパティ値
ブラシのコンテンツ。 既定値は、null
です。
注釈
VisualBrush の Visual コンテンツを指定する方法は 2 つあります。
新しい Visual を作成し、それを使用して VisualBrush の Visual プロパティを設定する。
ターゲットの Visual の複製イメージを作成する既存の Visual を使用する。 その後、VisualBrush を使用して、反射や拡大などの面白い効果を作り出すことができます。
Visual は WPF クラス階層全体で非常に高いため、非常に多くのオブジェクトが、 VisualBrush使用するビジュアルとして機能する可能性があります。リスト全体をここに表示することはできません。 「継承階層」セクションを参照してください Visual。すぐに派生したクラスが表示されます。 その後、すぐに派生したクラスをクリックし、階層を走査して、さまざまな可能性を把握できます。 最上位レベルでは、2 つの最も一般的なカテゴリのオブジェクトを VisualBrush UIElement ContainerVisual使用できます。 UIElement には基本的に、WPF アプリケーションの UI に参加できる UI 要素が含まれます。 ContainerVisualには、1 つ以上Drawingの派生オブジェクトを含む a DrawingGroup が含まれています。
VisualBrush の新しい Visual を定義し、その Visual が UIElement (パネルやコントロールなど) である場合、AutoLayoutContent プロパティが true
に設定されていると、レイアウト システムは UIElement とその子要素に対して実行されます。 ただし、ルート UIElement は基本的にシステムの残りの部分から分離されています。ブラシが適用されている親によって指定されたスタイル、ストーリーボード、外部レイアウトは、この境界に浸透できません。 ルートの UIElement は、唯一の親が VisualBrush であるために塗りつぶす領域に合わせて自動的にそれ自体のサイズを調整できないので、そのサイズを明示的に指定する必要があります。 Windows Presentation Foundation (WPF) でのレイアウトの詳細については、「レイアウト」を参照してください。
a がブラシの親チェーンにある場合BitmapEffect、a VisualBrush のビジュアル ツリーの更新は反映されません。 この制限を回避するには、エフェクトの上にあるオブジェクトのシーンを強制的に更新します。 アニメーションを呼び出 InvalidateVisual したり含めたりして、シーンの更新を強制することができます。
注意
VisualBrushプロパティが次の値以外の値に設定されている場合、A Visual を読み取り専用 (固定) にすることはできませんnull.
XAML プロパティ要素の使用
<object>
<object.Visual>
singleVisualRoot
</object.Visual>
</object>
XAML 属性の使用方法
<オブジェクト Visual
="{bindingExpression}"/>
- または -
<オブジェクト Visual
="{resourceExpression}"/>
XAML 値
singleVisualRoot
ブラシの新しいビジュアル要素を定義する 1 つのオブジェクト要素。 これは、派生 Visual元のオブジェクトである必要があります。 「解説」を参照してください。
bindingExpression
既存 Visual のインスタンスに評価される式。
resourceExpression
StaticResource
既存のインスタンスに評価される、またはDynamicResource
評価Visualされるインスタンス。 「XAML リソース」を参照してください。
依存プロパティ情報
識別子フィールド | VisualProperty |
に設定されたメタデータ プロパティ true |
なし |