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。「継承階層」セクションを参照してください。このセクションには、すぐに派生したクラスが表示されます。 その後、すぐに派生したクラスをクリックし、階層を走査して、可能性の全範囲を理解できます。 最上位レベルでは、 に使用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 |
なし |
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示