Brush 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
定義用於繪製圖形物件的物件。 源自 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, IAnimationObjectPublic 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"/>
- 繼承
- 衍生
- 屬性
- 實作
備註
關於 Brush 所代表的 UI 繪圖概念的範例與進一步說明，請參見 XAML 筆刷。
筆刷作為 XAML 資源
XAML 中可宣告的筆刷類型（例如 SolidColorBrush、 LinearGradientBrush 和 ImageBrush）是設計為資源，方便在整個應用程式中重複使用。 筆刷類型所展示的 XAML 語法適合用來定義筆刷作為資源。 當你宣告筆刷為資源時，還需要一個 x：Key 屬性 ，之後用它來參考其他 UI 定義中的該資源。 欲了解更多 XAML 資源及如何使用 x：Key 屬性，請參閱 ResourceDictionary 與 XAML 資源參考。
將筆刷宣告為資源的優點是減少了構建 UI 所需的執行時物件數量：筆刷現在作為共用資源，為物件圖的多個部分提供值。
如果你查看現有 Windows 執行階段 XAML 控制項的控制範本定義，你會發現這些範本大量使用筆刷資源。 這些資源中有許多是系統資源，它們使用 {ThemeResource} 標記擴充功能 作為資源參考，而非 {StaticResource} 標記擴充功能。 欲了解更多如何在你自己的控制模板 XAML 中使用系統資源筆刷的資訊，請參閱 XAML 主題資源。
刷 子衍生類別
筆刷是多個衍生類別的父類別，這些類別要麼實作實際的筆刷來繪製 UI 區域，要麼是這些筆刷的中間基底類別：
- GradientBrush： LinearGradientBrush 的中間基底類別。
- SolidColorBrush：這是目前使用最常用的筆刷。
- TileBrush： ImageBrush 的中間基底類別。
建構函式
| 名稱 | Description |
|---|---|
| Brush() |
提供筆 刷衍生類別的基底類別初始化行為。 |
屬性
| 名稱 | Description |
|---|---|
| Dispatcher |
它總是在 Windows 應用程式 SDK 應用程式中回傳 |
| DispatcherQueue |
得到 |
| Opacity |
取得或設定 筆刷的不透明度程度。 |
| OpacityProperty |
識別不 透明度 依賴性質。 |
| RelativeTransform |
取得或設定使用相對座標套用到筆刷上的轉換。 |
| RelativeTransformProperty |
識別 RelativeTransform 的相依性質。 |
| Transform |
取得或設定套用到畫筆上的轉換。 |
| TransformProperty |
識別 Transform 依賴性屬性。 |
方法
| 名稱 | Description |
|---|---|
| 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) |