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。

備註

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

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

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

整體 WPF 類別階層中 Visual 相當高，因此非常大量的物件可能會做為您用於 VisualBrush的視覺效果;無法在這裡顯示整個清單。 請參閱 Visual;請參閱「繼承階層」一節，其中會顯示立即衍生的類別。 然後，您可以按兩下立即衍生的類別並周遊階層，以瞭解各種可能性。 在最上層，您可能用於 VisualBrush 的兩個最常見的物件類別是 UIElement 或 ContainerVisual。 UIElement 基本上包含任何可以參與 WPF 應用程式 UI 的 UI 元素。 ContainerVisual 包含包含一或多個 Drawing衍生物件的 DrawingGroup。

當您為 VisualBrush 定義新的 Visual，且該 Visual 是 UIElement（例如面板或控件），當 AutoLayoutContent 屬性設定為 true時，配置系統會在 UIElement 及其子元素上執行。 不過，根 UIElement 基本上與系統的其餘部分隔離;套用筆刷的父系所指定的樣式、分鏡腳本和外部版面配置無法滲透到此界限。 因此，您應該明確地指定根 UIElement的大小，因為其唯一的父系是 VisualBrush，因此它無法自動將本身大小調整為繪製的區域。 如需 Windows Presentation Foundation 中版面配置的詳細資訊，請參閱 版面配置。

如果 BitmapEffect 位於筆刷的父鏈結中，VisualBrush 的可視化樹狀結構更新將不會傳播。 您可以強制在效果上方的物件上更新場景，以解決此問題。 您可以呼叫 InvalidateVisual 或包含動畫來強制場景更新。

注意

當 Visual 屬性設定為 null以外的任何值時，就無法將 VisualBrush 設為只讀 VisualBrush。

XAML 屬性元素使用方式

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

XAML 屬性使用方式

< 物件Visual=“{bindingExpression}”/>

-或-

< 物件Visual=“{resourceExpression}”/>

XAML 值

singleVisualRoot 定義筆刷新視覺元素的單一對象專案。 這必須是衍生自 Visual的物件。 請參閱。

bindingExpression 評估為現有 Visual 實例的表達式。

resourceExpression 評估為現有 Visual 實例的 StaticResource 或 DynamicResource。 請參閱 XAML 資源。

相依性屬性資訊

標識元欄位	VisualProperty
設定為 true 的元數據屬性	沒有