Brush 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
定義用於繪製圖形物件的物件。 衍生自的 Brush 類別描述該區域的繪畫方式。
public ref class Brush abstract : System::Windows::Media::Animation::Animatable, IFormattable[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public abstract class Brush : System.Windows.Media.Animation.Animatable, IFormattable[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Brush = class
inherit Animatable
interface IFormattable
interface DUCE.IResource[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Brush = class
inherit Animatable
interface IFormattablePublic MustInherit Class Brush
Inherits Animatable
Implements IFormattable- 繼承
- 衍生
- 屬性
- 實作
備註
A Brush 用輸出「繪製」或「填滿」一個區域。 不同的筆刷有不同類型的輸出。 有些畫筆會用純色繪製區域，有些則會用漸層、圖案、圖像或繪畫。 以下列表描述不同類型的 WPF 筆刷：
SolidColorBrush：會用實心 Color繪製一個區域。
LinearGradientBrush：以線性漸層繪製區域。
RadialGradientBrush：會以放射狀漸層繪製區域。
ImageBrush：以一個物件表示 ImageSource 的圖像繪製區域。
DrawingBrush：將區域繪製為 Drawing。 繪圖可能包含向量與點陣物件。
VisualBrush：用一個物件來繪製一個區域 Visual 。 A VisualBrush 讓你能將應用程式中一個部分的內容複製到另一個區域;它對於製作反射效果和放大螢幕部分非常實用。
預設筆刷
使用類別 Brushes 來繪製物件，使用預設的純色，例如 AliceBlue 或 Red。
XAML 中的筆刷
下表列出 XAML 中可用的不同 Brush 類型及其支援的語法。 如需特定筆刷的詳細語法資訊，請參閱該筆刷的類型頁面。
| Class | 屬性語法 | 物件元素語法 |
|---|---|---|
| SolidColorBrush | 是的 | 是的 |
| DrawingBrush | No | 是的 |
| ImageBrush | No | 是的 |
| LinearGradientBrush | No | 是的 |
| RadialGradientBrush | No | 是的 |
| VisualBrush | No | 是的 |
若想了解如何快速用純色繪製區域，請參見 《如何：用純色繪製區域》。
可凍結功能
畫筆是一種物 Freezable 體。 關於 Freezable 功能資訊，如凍結與複製，請參閱 可凍結物件概覽。
XAML 文字使用
如需 XAML 相關資訊，請參閱 備註 區。
給實施者的注意事項
當你從 Brush 該類別繼承時，必須覆寫該 CreateInstanceCore() 方法。 根據你的類別是否需要執行額外的初始化工作，或是否包含非相依屬性資料成員，你可能需要覆蓋其他 Freezable 方法。 欲了解更多關於從 Freezable 型別繼承的資訊，請參閱 可凍結物件概覽。
建構函式
| 名稱 | Description |
|---|---|
| Brush() |
初始化 Brush 類別的新執行個體。 |
欄位
| 名稱 | Description |
|---|---|
| OpacityProperty |
識別 Opacity 依賴性質。 |
| RelativeTransformProperty |
識別 RelativeTransform 依賴性質。 |
| TransformProperty |
識別 Transform 依賴性質。 |
屬性
| 名稱 | Description |
|---|---|
| CanFreeze |
會得到一個值，表示該物件是否能被設定為不可修改。 (繼承來源 Freezable) |
| DependencyObjectType |
會取得 DependencyObjectType 包裹此實例 CLR 類型的 。 (繼承來源 DependencyObject) |
| Dispatcher |
了解 Dispatcher 這與此 DispatcherObject 有關。 (繼承來源 DispatcherObject) |
| HasAnimatedProperties |
會得到一個值，表示是否有一個或多個 AnimationClock 物件與該物件的相依屬性相關聯。 (繼承來源 Animatable) |
| IsFrozen |
會得到一個值，表示該物件目前是否可修改。 (繼承來源 Freezable) |
| IsSealed |
會獲得一個值，表示該實例目前是否封存（唯讀）。 (繼承來源 DependencyObject) |
| Opacity |
取得或設定 的 Brush不透明度度。 |
| RelativeTransform |
取得或設定使用相對座標套用到筆刷上的轉換。 |
| Transform |
取得或設定套用到畫筆上的轉換。 此轉換是在畫筆輸出映射並定位後進行。 |
方法
事件
| 名稱 | Description |
|---|---|
| Changed |
當 Freezable 它所包含的物件被修改時，會發生這種情況。 (繼承來源 Freezable) |
明確介面實作
| 名稱 | Description |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
使用指定的格式，格式化目前實例的值。 |
