AcrylicBrush 類別

定義

命名空間:

Windows.UI.Xaml.Media

繪製一個使用多種效果的半透明材質區域，這些效果包括模糊和雜訊紋理。

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

/// [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 AcrylicBrush : 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 AcrylicBrush : XamlCompositionBrushBase

function AcrylicBrush()

Public Class AcrylicBrush
Inherits XamlCompositionBrushBase

繼承

Object IInspectable DependencyObject Brush XamlCompositionBrushBase AcrylicBrush

屬性

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)

備註

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1903	18362	TintLuminosityOpacity

建構函式

AcrylicBrush()

初始化 AcrylicBrush 類別的新實例。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.-ctor (適用于Windows 應用程式 SDK的 WinUI，請參閱Windows 應用程式 SDK命名空間) 。

屬性

AlwaysUseFallback	取得或設定值，指定筆刷是否強制使用純色後援色彩。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallback (for WinUI 在Windows 應用程式 SDK中，請參閱Windows 應用程式 SDK命名空間) 。
AlwaysUseFallbackProperty	識別 AlwaysUseFallback 相依性屬性。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallbackProperty (Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
BackgroundSource	取得或設定值，指定應用程式內容中的筆刷樣本，或從應用程式視窗後方的內容。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSource (在Windows 應用程式 SDK中，請參閱Windows 應用程式 SDK命名空間) 。
BackgroundSourceProperty	識別 BackgroundSource 相依性屬性。 適用于 UWP的對等WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSourceProperty (Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
CompositionBrush	取得或設定這個 XAML 筆刷所使用的 CompositionBrush 。 (繼承來源 XamlCompositionBrushBase)
Dispatcher	取得與此物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可以存取 UI 執行緒上DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject)
FallbackColor	當 CompositionBrush 無法轉譯時所使用的色彩。 (繼承來源 XamlCompositionBrushBase)
Opacity	取得或設定 Brush不透明度的程度。 (繼承來源 Brush)
RelativeTransform	取得或設定使用相對座標套用到筆刷的轉換。 (繼承來源 Brush)
TintColor	取得或設定半透明壓克力材質的色彩色調。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintColor (Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
TintColorProperty	識別 TintColor 相依性屬性。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintColorProperty (Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
TintLuminosityOpacity	取得或設定 TintColor 與壓克力表面後方基礎圖元之間的亮度量。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacity (Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
TintLuminosityOpacityProperty	識別 TintLuminosityOpacity 相依性屬性。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacityProperty (，請參閱Windows 應用程式 SDK中 WinUI的Windows 應用程式 SDK命名空間) 。
TintOpacity	取得或設定色彩色調不透明度的程度。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacity (Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
TintOpacityProperty	識別 TintOpacity 相依性屬性。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacityProperty (Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。
TintTransitionDuration	取得或設定 TintColor 變更時所使用的自動轉換動畫長度。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDuration (在Windows 應用程式 SDK中，請參閱Windows 應用程式 SDK命名空間) 。
TintTransitionDurationProperty	識別 TintTransitionDuration 相依性屬性。 適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDurationProperty (適用于Windows 應用程式 SDK中的 WinUI，請參閱Windows 應用程式 SDK命名空間) 。
Transform	取得或設定套用到筆刷的轉換。 (繼承來源 Brush)

方法

ClearValue(DependencyProperty)	清除相依性屬性的本機值。 (繼承來源 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	傳回針對相依性屬性所建立的任何基底值，如果動畫未使用中，則會套用。 (繼承來源 DependencyObject)
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)
SetValue(DependencyProperty, Object)	在 DependencyObject上設定相依性屬性的本機值。 (繼承來源 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback註冊的變更通知。 (繼承來源 DependencyObject)

另請參閱

• 壓克力材質概觀