Brush 類別

定義

命名空間:

Windows.UI.Xaml.Media

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

public ref class Brush : DependencyObject, IAnimationObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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

衍生

Windows.UI.Xaml.Media.GradientBrush

Windows.UI.Xaml.Media.SolidColorBrush

Windows.UI.Xaml.Media.TileBrush

Windows.UI.Xaml.Media.XamlCompositionBrushBase

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IAnimationObject

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

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

XAML 資源形式的筆刷

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

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

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

筆刷 衍生類別

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

• GradientBrush： LinearGradientBrush的中繼基類。
• SolidColorBrush：這是目前最常使用的 Brush。
• TileBrush： ImageBrush的中繼基類。

版本歷程記錄

Windows 版本	SDK 版本	新增值
1809	17763	PopulatePropertyInfo
1809	17763	PopulatePropertyInfoOverride

建構函式

Brush()

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

屬性

Dispatcher	取得這個 物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可在 UI 執行緒上存取DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject)
Opacity	取得或設定 Brush的不透明度。
OpacityProperty	識別 Opacity 相依性屬性。
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)

另請參閱

• DependencyObject
• SolidColorBrush
• Color
• Colors
• 使用筆刷
• Image 和 ImageBrush
• ResourceDictionary 與 XAML 資源參考