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 內容。

• 建立新的 Visual，並將其用來設定 Visual 的 VisualBrush 屬性。

• 使用現有的Visual，這會建立目標Visual的重複映像。 然後您就可以使用 VisualBrush 建立有趣的效果，例如反射與放大。

Visual 在整體 WPF 類別階層中相當高，因此大量物件可能作為你用於 VisualBrush;;完整清單無法在此顯示。 參見 Visual;請參考「繼承階層」章節，該章節將顯示立即衍生的類別。 然後，您可以按兩下立即衍生的類別並周遊階層，以瞭解各種可能性。 在最高層次，你最 VisualBrush 常用的兩類物件是 UIElement 或 ContainerVisual。 UIElement 基本上涵蓋任何可以參與 WPF 應用程式 UI 的 UI 元素。 ContainerVisual 包含 DrawingGroup 一個或多個 Drawing-導出物件的 a。

當您為Visual定義新的VisualBrush時，且該Visual是UIElement(例如面板或控制項)，配置系統會在UIElement及其子元素上運行，當AutoLayoutContent屬性被設置為true時。 然而，根 UIElement 節點基本上與系統其他部分隔離;由筆刷所施加的父節點所決定的樣式、分鏡和外部佈局無法穿透此邊界。 因此，您應該明確指定根UIElement的大小，因為它唯一的父系是VisualBrush，所以它無法根據被繪製的區域來自動調整大小。 如需 Windows Presentation Foundation (WPF) 中版面配置的詳細資訊，請參閱 版面配置。

如果 a VisualBrush 在刷子的父鏈中，對 a BitmapEffect 的視覺樹更新不會發生。 您可以強制在效果上方的物件上更新場景，以解決此問題。 你可以呼叫 InvalidateVisual 或加入動畫來強制場景更新。

XAML 屬性元素使用方式

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

XAML 屬性使用方式

< 目的Visual=“{bindingExpression}”/>

-或-

< 目的Visual=“{resourceExpression}”/>

XAML 值

singleVisualRoot 一個單一物件元素定義了筆刷的新視覺元素。 這必須是一個由 Visual衍生出來的對象。 請參閱備註。

bindingExpression 一個對已存在 Visual 實例進行評估的表達式。

resourceExpression StaticResource A 或 DynamicResource 該評估為已存在Visual的實例。 請參閱 XAML 資源。

相依財產資訊