AcrylicBrush Kelas

Definisi

Ruang nama:

Windows.UI.Xaml.Media

Mengecat area dengan bahan semi transparan yang menggunakan beberapa efek termasuk kabur dan tekstur kebisingan.

API WinUI 2 yang setara untukUWP: Microsoft.UI.Xaml.Media.AcrylicBrush (untuk WinUI diSDK Aplikasi Windows , lihat namespace 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

Warisan

Object IInspectable DependencyObject Brush XamlCompositionBrushBase AcrylicBrush

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 Fall Creators Update (diperkenalkan dalam 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v5.0)

Contoh

Ujung

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat materi Acrylic.

Jika Anda telah menginstal aplikasi Galeri WinUI 2 , klik di sini untuk membuka aplikasi dan lihat Akrilik beraksi.

• Dapatkan aplikasi Galeri WinUI 2 (Microsoft Store)
• Dapatkan kode sumber (GitHub)

Untuk menambahkan kuas akrilik, tentukan tiga sumber daya untuk tema kontras gelap, terang, dan tinggi. Perhatikan bahwa sebaliknya, sebaiknya gunakan SolidColorBrush dengan x:Key yang sama dengan AcrylicBrush gelap/terang.

Nota

Jika Anda tidak menentukan nilai TintLuminosityOpacity, sistem akan secara otomatis menyesuaikan nilainya berdasarkan TintColor dan TintOpacity Anda.

<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>

Contoh ini menunjukkan cara membuat AcrylicBrush dalam kode. Jika aplikasi Anda mendukung beberapa target OS, pastikan untuk memeriksa apakah API ini tersedia di komputer pengguna sebelum Anda menggunakannya.

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;
}

Keterangan

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1903	18362	TintLuminosityOpacity

Konstruktor

AcrylicBrush()

Menginisialisasi instans baru kelas AcrylicBrush. API WinUI 2 yang setara untukUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.-ctor (untuk WinUI diSDK Aplikasi Windows , lihat namespace layanan SDK Aplikasi Windows ).

Properti

AlwaysUseFallback	Mendapatkan atau menetapkan nilai yang menentukan apakah kuas dipaksa ke warna fallback padat. API WinUI 2 yang setara untukUWP : Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallback (untuk WinUI di Windows App SDK, lihat namespace layanan Windows App SDK ).
AlwaysUseFallbackProperty	Mengidentifikasi properti dependensi AlwaysUseFallback. API WinUI 2 yang setara untukUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallbackProperty (untuk WinUI di Windows App SDK , lihat namespace layanan SDK Aplikasi Windows ).
BackgroundSource	Mendapatkan atau menetapkan nilai yang menentukan apakah sampel kuas dari konten aplikasi atau dari konten di belakang jendela aplikasi. API WinUI 2 yang setara untukUWP : Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSource (untuk WinUI diSDK Aplikasi Windows , lihat namespace layanan SDK Aplikasi Windows ).
BackgroundSourceProperty	Mengidentifikasi properti dependensi BackgroundSource. API WinUI 2 yang setara untukUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSourceProperty (untuk WinUI di Windows App SDK, lihat namespace layanan Windows App SDK ).
CompositionBrush	Mendapatkan atau mengatur KomposisiBrush digunakan oleh sikat XAML ini. (Diperoleh dari XamlCompositionBrushBase)
Dispatcher	Mendapatkan CoreDispatcher yang terkait dengan objek ini. CoreDispatcher mewakili fasilitas yang dapat mengakses DependencyObject pada utas UI bahkan jika kode dimulai oleh utas non-UI. (Diperoleh dari DependencyObject)
FallbackColor	Warna yang digunakan untuk penyajian jika KomposisiBrush tidak dapat dirender. (Diperoleh dari XamlCompositionBrushBase)
Opacity	Mendapatkan atau menetapkan tingkat keburaman Brush. (Diperoleh dari Brush)
RelativeTransform	Mendapatkan atau mengatur transformasi yang diterapkan pada kuas menggunakan koordinat relatif. (Diperoleh dari Brush)
TintColor	Mendapatkan atau mengatur warna warna untuk bahan akrilik semi transparan. API WinUI 2 yang setara untukUWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintColor (untuk WinUI diSDK Aplikasi Windows , lihat namespace layanan Windows App SDK ).
TintColorProperty	Mengidentifikasi properti dependensi TintColor. API WinUI 2 yang setara untukUWP : Microsoft.UI.Xaml.Media.AcrylicBrush.TintColorProperty (untuk WinUI di Windows App SDK, lihat namespace Windows App SDK).
TintLuminosityOpacity	Mendapatkan atau mengatur jumlah kecerahan antara TintColor dan piksel yang mendasar di belakang permukaan Akrilik. API WinUI 2 yang setara untukUWP : Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacity (untuk WinUI diWindows App SDK , lihat namespace Windows App SDK).
TintLuminosityOpacityProperty	Mengidentifikasi properti dependensi TintLuminosityOpacity. API WinUI 2 yang setara untukUWP : Microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacityProperty (untuk WinUI diWindows App SDK , lihat namespace layanan SDK Aplikasi Windows ).
TintOpacity	Mendapatkan atau mengatur tingkat keburaman warna. API WinUI 2 yang setara untukUWP : Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacity (untuk WinUI diSDK Aplikasi Windows , lihat namespace layanan SDK Aplikasi Windows ).
TintOpacityProperty	Mengidentifikasi properti dependensi TintOpacity. Equivalent WinUI 2 API for UWP: Microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacityProperty (untuk WinUI diWindows App SDK , lihat namespace Windows App SDK).
TintTransitionDuration	Mendapatkan atau mengatur panjang animasi transisi otomatis yang digunakan saat TintColor berubah. API WinUI 2 yang setara untukUWP : Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDuration (untuk WinUI di Windows App SDK , lihat namespace layanan SDK Aplikasi Windows ).
TintTransitionDurationProperty	Mengidentifikasi properti dependensi TintTransitionDuration. API WinUI 2 yang setara untukUWP : Microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDurationProperty (untuk WinUI di Windows App SDK, lihat namespace layanan SDK Aplikasi Windows ).
Transform	Mendapatkan atau mengatur transformasi yang diterapkan pada kuas. (Diperoleh dari Brush)

Metode

ClearValue(DependencyProperty)	Menghapus nilai lokal properti dependensi. (Diperoleh dari DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Mengembalikan nilai dasar apa pun yang ditetapkan untuk properti dependensi, yang akan berlaku dalam kasus di mana animasi tidak aktif. (Diperoleh dari DependencyObject)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini dari DependencyObject. (Diperoleh dari DependencyObject)
OnConnected()	Dipanggil ketika kuas pertama kali digunakan pada layar untuk melukis elemen. Ketika diimplementasikan dalam kelas turunan, Anda dapat membuat instans KomposisiBrush dan menyediakannya ke kerangka kerja dengan mengatur properti KomposisiBrush. onDisconnected akan dipanggil ketika kuas tidak lagi digunakan untuk melukis elemen apa pun. (Diperoleh dari XamlCompositionBrushBase)
OnDisconnected()	Dipanggil ketika kuas tidak lagi digunakan untuk melukis elemen apa pun. Ketika diimplementasikan dalam kelas turunan, Anda dapat dengan aman membuang kuas kompossi dan sumber daya komposisi lainnya. OnConnected akan dipanggil lagi jika kuas kemudian digunakan untuk melukis elemen apa pun setelah terputus. (Diperoleh dari XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Menentukan properti yang dapat dianimasikan. (Diperoleh dari Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Saat ditimpa dalam kelas turunan, menentukan properti yang dapat dianimasikan. (Diperoleh dari Brush)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika nilai lokal diatur. (Diperoleh dari DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Mendaftarkan fungsi pemberitahuan untuk mendengarkan perubahan pada DependencyProperty tertentu pada instans DependencyObject ini. (Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi pada DependencyObject. (Diperoleh dari DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Membatalkan pemberitahuan perubahan yang sebelumnya terdaftar dengan memanggil RegisterPropertyChangedCallback. (Diperoleh dari DependencyObject)

Lihat juga

• ikhtisar material Acrylic