Brush 類別

  • 參考

定義

命名空間:
Microsoft.UI.Xaml.Media
編輯

定義用來繪製圖形物件的物件。 衍生自 Brush 的類別描述如何繪製區域。

public ref class Brush : DependencyObject, IAnimationObject
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Brush : DependencyObject, IAnimationObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Brush : DependencyObject, IAnimationObject
Public Class Brush
Inherits DependencyObject
Implements IAnimationObject
<object property="predefinedColorName"/>
- or -
<object property="#rgb"/>
- or -
<object property="#argb"/>
- or -
<object property="#rrggbb"/>
- or -
<object property="#aarrggbb"/>
- or -
<object property="sc#scR,scG,scB"/>
- or -
<object property="sc#scA,scR,scG,scB"/>
繼承
Object Platform::Object IInspectable DependencyObject Brush
衍生
屬性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
實作
IAnimationObject

備註

如需 Brush 所代表 UI 繪圖概念的範例和進一步說明，請參閱 XAML 筆刷。

XAML 資源形式的筆刷

可以在 XAML (中宣告的 Brush 類型，例如 SolidColorBrush、 LinearGradientBrush 和 ImageBrush) ，是要定義為資源，以便在整個應用程式中輕鬆重複使用。 針對 Brush 類型顯示的 XAML 語法適用於將筆刷定義為資源。 當您將筆刷宣告為資源時，您也需要 x：Key 屬性 ，稍後您將用來從其他 UI 定義參考該資源。 如需 XAML 資源及如何使用 x：Key 屬性的詳細資訊，請參閱 ResourceDictionary 和 XAML 資源參考。

將筆刷宣告為資源的優點是可減少建構 UI 所需的運行時間物件數目：筆刷現在會共用為物件圖形多個部分提供值的通用資源。

如果您查看 Windows 執行階段 XAML 控件的現有控件範本定義，您會看到範本會廣泛地使用筆刷資源。 其中許多資源都是系統資源，而且會針對資源參考使用 {ThemeResource} 標記延伸 ，而不是 {StaticResource} 標記延伸。 如需如何在您自己的控件範本 XAML 中使用系統資源筆刷的詳細資訊，請參閱 XAML 主題資源。

筆刷 衍生類別

Brush 是數個衍生類別的父類別，可實作繪製 UI 區域的實際筆刷，或是這類筆刷的中繼基類：

建構函式

Brush()

提供 Brush 衍生類別的基類初始化行為。

屬性

Dispatcher

一律會在 Windows 應用程式 SDK 應用程式中傳回null。 請改用 DispatcherQueue 。

(繼承來源 DependencyObject)
DispatcherQueue

DispatcherQueue取得與這個 物件相關聯的 。 DispatcherQueue表示即使程式代碼是由非 UI 線程起始，也可以存取 DependencyObject UI 線程上的 。

(繼承來源 DependencyObject)
Opacity

取得或設定 Brush 不透明度的程度。
OpacityProperty

識別 不透明度 相依性屬性。
RelativeTransform

取得或設定使用相對座標套用到筆刷的轉換。
RelativeTransformProperty

識別 RelativeTransform 相依性屬性。
Transform

取得或設定套用到筆刷的轉換。
TransformProperty

識別 轉換 相依性屬性。

方法

ClearValue(DependencyProperty)

清除相依性屬性的本機值。

(繼承來源 DependencyObject)
GetAnimationBaseValue(DependencyProperty)

傳回針對相依性屬性所建立的任何基底值，如果動畫未使用中，則會套用。

(繼承來源 DependencyObject)
GetValue(DependencyProperty)

從 DependencyObject 傳回相依性屬性的目前有效值。

(繼承來源 DependencyObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)

定義可以產生動畫效果的屬性。
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

在衍生類別中覆寫時，定義可產生動畫效果的屬性。
ReadLocalValue(DependencyProperty)

如果已設定本機值，則傳回相依性屬性的本機值。

(繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

註冊通知函式，以接聽此 DependencyObject 實例上特定 DependencyProperty 的變更。

(繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)

在 DependencyObject 上設定相依性屬性的本機值。

(繼承來源 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

取消先前透過呼叫 RegisterPropertyChangedCallback 註冊的變更通知。

(繼承來源 DependencyObject)

適用於

另請參閱