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 (中宣告的 Brush 類型，例如 SolidColorBrush、 LinearGradientBrush 和 ImageBrush) ，是要定義為資源，以便在整個應用程式中輕鬆重複使用。 針對 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 的中繼基類。
建構函式
| Brush() |
提供 Brush 衍生類別的基類初始化行為。 |
屬性
| Dispatcher |
一律會在 Windows 應用程式 SDK 應用程式中傳回 |
| DispatcherQueue |
|
| 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) |