RevealBrush 類別

定義

命名空間:

Windows.UI.Xaml.Media

重要

RevealBrush 可用於需求一節中指定的作業系統。 不過，我們不建議使用，因為它可能會在後續版本中改變或無法使用。

筆刷的基底類別，會使用組合效果和光線來實作顯色視覺化設計處理方式。

適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush (Windows 應用程式 SDK中的 WinUI，請參閱Windows 應用程式 SDK命名空間) 。

public ref class RevealBrush : XamlCompositionBrushBase

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RevealBrush : XamlCompositionBrushBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class RevealBrush : XamlCompositionBrushBase

Public Class RevealBrush
Inherits XamlCompositionBrushBase

繼承

Object Platform::Object IInspectable DependencyObject Brush XamlCompositionBrushBase RevealBrush

衍生

Windows.UI.Xaml.Media.RevealBackgroundBrush

Windows.UI.Xaml.Media.RevealBorderBrush

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 Fall Creators Update (已於 10.0.16299.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v5.0 引進)

範例

提示

如需詳細資訊、設計指引和程式碼範例，請參閱 使用筆刷繪製背景、前景和大綱。

如果您已安裝 WinUI 2 資源庫 應用程式， 請開啟應用程式以查看控制項的運作情形。

• 取得 WinUI 2 資源庫應用程式 (Microsoft Store)
• 取得原始程式碼 (GitHub)

備註

XAML 附加屬性

RevealBrush 是 XAML 附加屬性的主機服務類別。

為了支援 XAML 處理器對附加屬性的存取，以及公開對等 的 get 和 set 作業給程式碼，每個 XAML 附加屬性都有一對 Get 和 Set 存取子方法。 在程式碼中取得或設定值的另一種方式是使用相依性屬性系統，呼叫 GetValue 或 SetValue 並將識別碼欄位傳遞為相依性屬性識別碼。

附加屬性	描述
State	取得或設定值，這個值表示使用此筆刷之專案的指標狀態。

建構函式

RevealBrush()

重要 RevealBrush 可用於需求一節中指定的作業系統。 不過，不建議使用，因為後續版本可能會改變或無法使用。 提供 RevealBrush 衍生類別的基類初始化行為。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.-ctor (適用于Windows 應用程式 SDK中的 WinUI，請參閱Windows 應用程式 SDK命名空間) 。

屬性

AlwaysUseFallback	重要 RevealBrush 可用於需求一節中指定的作業系統。 不過，不建議使用，因為後續版本可能會改變或無法使用。 取得或設定值，指定筆刷是否強制使用純色後援色彩。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.AlwaysUseFallback (在Windows 應用程式 SDK中，請參閱Windows 應用程式 SDK命名空間) 。
AlwaysUseFallbackProperty	重要 RevealBrush 可用於需求一節中指定的作業系統。 不過，不建議使用，因為後續版本可能會改變或無法使用。 識別 AlwaysUseFallback 相依性屬性。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.AlwaysUseFallbackProperty (Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
Color	重要 RevealBrush 可用於需求一節中指定的作業系統。 不過，不建議使用，因為後續版本可能會改變或無法使用。 取得或設定值，指定筆刷的基底背景色彩。 適用于 UWP的對等WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.Color (for WinUI in the Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
ColorProperty	重要 RevealBrush 可用於需求一節中指定的作業系統。 不過，不建議使用，因為後續版本可能會改變或無法使用。 識別 Color 相依性屬性。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.ColorProperty (Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
CompositionBrush	取得或設定這個 XAML 筆刷所使用的 CompositionBrush 。 (繼承來源 XamlCompositionBrushBase)
Dispatcher	取得與此物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可以存取 UI 執行緒上DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject)
FallbackColor	當 CompositionBrush 無法轉譯時所使用的色彩。 (繼承來源 XamlCompositionBrushBase)
Opacity	取得或設定 Brush不透明度的程度。 (繼承來源 Brush)
RelativeTransform	取得或設定使用相對座標套用到筆刷的轉換。 (繼承來源 Brush)
StateProperty	重要 RevealBrush 可用於需求一節中指定的作業系統。 不過，不建議使用，因為後續版本可能會改變或無法使用。 識別 RevealBrush.State 附加屬性。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.StateProperty (適用于Windows 應用程式 SDK中的 WinUI，請參閱Windows 應用程式 SDK命名空間) 。
TargetTheme	重要 RevealBrush 可用於需求一節中指定的作業系統。 不過，不建議使用，因為後續版本可能會改變或無法使用。 取得或設定值，指定用來繪製筆刷和光線的主題，以確保正確的組合效果配方用於所需的主題。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.TargetTheme (for WinUI Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
TargetThemeProperty	重要 RevealBrush 可用於需求一節中指定的作業系統。 不過，不建議使用，因為後續版本可能會改變或無法使用。 識別 TargetTheme 相依性屬性。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.TargetThemeProperty (在Windows 應用程式 SDK中，請參閱Windows 應用程式 SDK命名空間) 。
Transform	取得或設定套用到筆刷的轉換。 (繼承來源 Brush)

附加屬性

State

取得或設定值，這個值表示使用此筆刷的專案指標狀態。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.State (for WinUI in the Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。

方法

ClearValue(DependencyProperty)	清除相依性屬性的本機值。 (繼承來源 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	傳回針對相依性屬性所建立的任何基底值，如果動畫未使用中，則會套用。 (繼承來源 DependencyObject)
GetState(UIElement)	重要 RevealBrush 可用於需求一節中指定的作業系統。 不過，不建議使用，因為後續版本可能會改變或無法使用。 取得目標專案的 RevealBrush.State XAML 附加屬性的值。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.GetState (Windows.UI.Xaml.UIElement) (for WinUI，請參閱Windows 應用程式 SDK) Windows 應用程式 SDK命名空間。
GetValue(DependencyProperty)	從 DependencyObject傳回相依性屬性的目前有效值。 (繼承來源 DependencyObject)
OnConnected()	在螢幕第一次使用筆刷繪製元素時叫用。 在衍生類別中實作時，您可以建立 CompositionBrush 實例，並藉由設定 CompositionBrush 屬性提供給架構。 當筆刷不再用來繪製任何元素時，將會呼叫OnDisconnected。 (繼承來源 XamlCompositionBrushBase)
OnDisconnected()	當筆刷不再用來繪製任何專案時叫用。 在衍生類別中實作時，您可以安全地處置撰寫筆刷和其他組合資源。 如果筆刷稍後用來在中斷連線之後繪製任何元素，則會再次呼叫OnConnected。 (繼承來源 XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定義可以產生動畫效果的屬性。 (繼承來源 Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	在衍生類別中覆寫時，定義可產生動畫效果的屬性。 (繼承來源 Brush)
ReadLocalValue(DependencyProperty)	如果已設定本機值，則會傳回相依性屬性的本機值。 (繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	註冊通知函式，以接聽此DependencyObject實例上特定DependencyProperty的變更。 (繼承來源 DependencyObject)
SetState(UIElement, RevealBrushState)	重要 RevealBrush 可用於需求一節中指定的作業系統。 不過，不建議使用，因為後續版本可能會改變或無法使用。 設定目標元素的 RevealBrush.State XAML 附加屬性的值。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.RevealBrush.SetState (Windows.UI.Xaml.UIElement，Microsoft.UI.Xaml.Media.RevealBrushState) (Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
SetValue(DependencyProperty, Object)	在 DependencyObject上設定相依性屬性的本機值。 (繼承來源 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback註冊的變更通知。 (繼承來源 DependencyObject)