共用方式為

VisualBrush.Visual 屬性

定義

命名空間:
System.Windows.Media
組件:
PresentationCore.dll

取得或設定筆刷的內容。

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。

備註

有兩種方式可以指定 Visual 。VisualBrush

  • 建立一個新檔案 Visual 並用它來設定 Visual 的 VisualBrush屬性。

  • 使用現有 Visual的 ，該影像會產生目標 Visual的複製影像。 接著你可以用這些 VisualBrush 來創造有趣的效果，例如反射和放大。

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

當你為 和 定義一個新物件VisualUIElementVisualVisualBrush（例如面板或控制項）時，當屬性AutoLayoutContent設為 true時，佈局系統會在 及其UIElement子元素上執行。 然而，根 UIElement 節點基本上與系統其他部分隔離;由筆刷所施加的父節點所決定的樣式、分鏡和外部佈局無法穿透此邊界。 因此，你應該明確指定根的 UIElement大小，因為它唯一的父節點是根 VisualBrush ，無法自動調整到被繪製的區域大小。 欲了解更多關於 Windows Presentation Foundation（WPF）版面的資訊，請參閱 版面版面。

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

注意

當 A VisualBrush 的屬性被設定為除 以外的任何值null時Visual，A不能被設為唯讀（凍結）。

XAML 屬性元素使用方式

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

XAML 屬性使用方式

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

-或-

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

XAML 值

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

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

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

相依性屬性資訊

項目 價值
標識元欄位 VisualProperty
元資料屬性設為 true 沒有

適用於