AcrylicBrush 類別

定義

命名空間:

Windows.UI.Xaml.Media

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

適用於 UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush （適用於 Windows App SDK中的 WinUI，請參閱 Windows App 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）

若要新增壓克力筆刷，請定義深色、淺色和高對比度主題的三個資源。 請注意，在高對比度中，我們建議使用 SolidColorBrush 與深色/淺壓克力Brush 相同的 x:Key。

注意

如果您未指定 TintLuminosityOpacity 值，系統會根據 TintColor 和 TintOpacity 自動調整其值。

<ResourceDictionary.ThemeDictionaries>
    <ResourceDictionary x:Key="Default">
        <AcrylicBrush x:Key="MyAcrylicBrush"
            BackgroundSource="HostBackdrop"
            TintColor="#FFFF0000"
            TintOpacity="0.8"
            TintLuminosityOpacity="0.5"
            FallbackColor="#FF7F0000"/>
    </ResourceDictionary>

    <ResourceDictionary x:Key="HighContrast">
        <SolidColorBrush x:Key="MyAcrylicBrush"
            Color="{ThemeResource SystemColorWindowColor}"/>
    </ResourceDictionary>

    <ResourceDictionary x:Key="Light">
        <AcrylicBrush x:Key="MyAcrylicBrush"
            BackgroundSource="HostBackdrop"
            TintColor="#FFFF0000"
            TintOpacity="0.8"
            TintLuminosityOpacity="0.5"
            FallbackColor="#FFFF7F7F"/>
    </ResourceDictionary>
</ResourceDictionary.ThemeDictionaries>

此範例示範如何在程序代碼中建立 AcrylicBrush。 如果您的應用程式支援多個 OS 目標，請務必先檢查用戶電腦上的此 API 是否可用，再使用它。

if (Windows.Foundation.Metadata.ApiInformation.IsTypePresent("Windows.UI.Xaml.Media.AcrylicBrush"))
{
    Windows.UI.Xaml.Media.AcrylicBrush myBrush = new Windows.UI.Xaml.Media.AcrylicBrush();
    myBrush.BackgroundSource = Windows.UI.Xaml.Media.AcrylicBackgroundSource.HostBackdrop;
    myBrush.TintColor = Color.FromArgb(255, 202, 24, 37);
    myBrush.FallbackColor = Color.FromArgb(255, 202, 24, 37);
    myBrush.TintOpacity = 0.6;

    grid.Fill = myBrush;
}
else
{
    SolidColorBrush myBrush = new SolidColorBrush(Color.FromArgb(255, 202, 24, 37));

    grid.Fill = myBrush;
}

備註

版本歷程記錄

Windows 版本	SDK 版本	增加值
1903	18362	TintLuminosityOpacity

建構函式

AcrylicBrush()

初始化 AcrylicBrush 類別的新實例。 適用於UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.-ctor （針對 Windows App SDK中的 WinUI，請參閱 Windows App SDK 命名空間）。

屬性

AlwaysUseFallback	取得或設定值，指定筆刷是否強制使用純色後援色彩。 適用於 UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallback （針對 Windows App SDK中的 WinUI，請參閱 Windows App SDK 命名空間]。
AlwaysUseFallbackProperty	識別AlwaysUseFallback相依性屬性。 適用於 UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallbackProperty （針對 Windows App SDK中的 WinUI，請參閱 Windows App SDK 命名空間]。
BackgroundSource	取得或設定值，指定從應用程式內容或應用程式視窗後方的內容，筆刷範例。 適用於UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSource （適用於 Windows App SDK中的 WinUI，請參閱 Windows App SDK 命名空間）。
BackgroundSourceProperty	識別 BackgroundSource 相依性屬性。 適用於UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSourceProperty （針對 Windows App SDK中的 WinUI，請參閱 Windows App 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 App SDK中的 WinUI，請參閱 Windows App SDK 命名空間）。
TintColorProperty	識別 TintColor 相依性屬性。 適用於UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintColorProperty （針對 Windows App SDK中的 WinUI，請參閱 Windows App SDK 命名空間）。
TintLuminosityOpacity	取得或設定 TintColor 與壓克力表面後方基礎像素之間的亮度量。 適用於 UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacity （針對 Windows App SDK中的 WinUI，請參閱 Windows App SDK 命名空間）。
TintLuminosityOpacityProperty	識別 TintLuminosityOpacity 相依性屬性。 適用於 UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacityProperty （針對 Windows App SDK中的 WinUI，請參閱 Windows App SDK 命名空間）。
TintOpacity	取得或設定色彩色調不透明度的程度。 適用於 UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacity （針對 Windows App SDK中的 WinUI，請參閱 Windows App SDK 命名空間]。
TintOpacityProperty	識別 TintOpacity 相依性屬性。 適用於UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacityProperty （針對 Windows App SDK中的 WinUI，請參閱 Windows App SDK 命名空間）。
TintTransitionDuration	取得或設定 TintColor 變更時所使用的自動轉換動畫長度。 適用於UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDuration （針對 Windows App SDK中的 WinUI，請參閱 Windows App SDK 命名空間）。
TintTransitionDurationProperty	識別 TintTransitionDuration 相依性屬性。 適用於UWP的對等 WinUI 2 API：Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDurationProperty （針對 Windows App SDK中的 WinUI，請參閱 Windows App 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)

另請參閱

• 壓克力材質概觀