Brush Kelas

Definisi

Ruang nama:

Windows.UI.Xaml.Media

Mendefinisikan objek yang digunakan untuk melukis objek grafis. Kelas yang berasal dari Brush menggambarkan bagaimana area dicat.

public ref class Brush : DependencyObject, IAnimationObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Brush : DependencyObject, IAnimationObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Brush : DependencyObject, IAnimationObject

Public Class Brush
Inherits DependencyObject
Implements IAnimationObject

<object property="predefinedColorName"/>
- or -
<object property="#rgb"/>
- or -
<object property="#argb"/>
- or -
<object property="#rrggbb"/>
- or -
<object property="#aarrggbb"/>
- or -
<object property="sc#scR,scG,scB"/>
- or -
<object property="sc#scA,scR,scG,scB"/>

Warisan

Object Platform::Object IInspectable DependencyObject Brush

Turunan

Windows.UI.Xaml.Media.GradientBrush

Windows.UI.Xaml.Media.SolidColorBrush

Windows.UI.Xaml.Media.TileBrush

Windows.UI.Xaml.Media.XamlCompositionBrushBase

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IAnimationObject

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Untuk contoh dan penjelasan lebih lanjut tentang konsep gambar UI yang diwakili oleh Brush, lihat Menggunakan kuas.

Sikat sebagai sumber daya XAML

Masing-masing jenis Brush yang dapat dideklarasikan dalam XAML (SolidColorBrush, LinearGradientBrush, ImageBrush) dimaksudkan untuk didefinisikan sebagai sumber daya, sehingga Anda dapat menggunakan kembali kuas tersebut sebagai sumber daya di seluruh aplikasi Anda. Sintaks XAML yang ditampilkan untuk jenis Brush sesuai untuk menentukan kuas sebagai sumber daya. Saat Anda mendeklarasikan kuas sebagai sumber daya, Anda juga memerlukan atribut x:Key yang nantinya akan Anda gunakan untuk merujuk ke sumber daya tersebut dari definisi UI lainnya. Untuk informasi selengkapnya tentang sumber daya XAML dan cara menggunakan atribut x:Key, lihat Referensi sumber daya ResourceDictionary dan XAML.

Keuntungan mendeklarasikan kuas sebagai sumber daya adalah mengurangi jumlah objek runtime yang diperlukan untuk membangun UI: kuas sekarang dibagikan sebagai sumber daya umum yang memberikan nilai untuk beberapa bagian grafik objek.

Jika Anda melihat definisi templat kontrol yang ada untuk kontrol XAML Windows Runtime, Anda akan melihat bahwa templat menggunakan sumber daya kuas secara ekstensif. Banyak dari sumber daya ini adalah sumber daya sistem, dan mereka menggunakan ekstensi markup {ThemeResource} untuk referensi sumber daya daripada ekstensi markup {StaticResource}. Untuk informasi selengkapnya tentang cara menggunakan kuas sumber daya sistem di XAML templat kontrol Anda sendiri, lihat sumber daya tema XAML.

Kelas turunan kuas

Brush adalah kelas induk untuk beberapa kelas turunan yang mengimplementasikan kuas praktis yang melukis wilayah UI, atau merupakan kelas dasar perantara untuk kuas tersebut:

• GradientBrush: Kelas dasar menengah untuk LinearGradientBrush.
• SolidColorBrush: Sejauh ini adalah Brush yang paling umum digunakan.
• Petak PetaBrush: Kelas dasar menengah untuk ImageBrush.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1809	17763	PopulatePropertyInfo
1809	17763	PopulatePropertyInfoOverride

Konstruktor

Brush()

Menyediakan perilaku inisialisasi kelas dasar untuk kelas turunan Brush.

Properti

Dispatcher	Mendapatkan CoreDispatcher yang dikaitkan dengan objek ini. CoreDispatcher mewakili fasilitas yang dapat mengakses DependencyObject pada utas UI bahkan jika kode dimulai oleh utas non-UI. (Diperoleh dari DependencyObject)
Opacity	Mendapatkan atau menetapkan tingkat keburaman kuas.
OpacityProperty	Mengidentifikasi properti dependensi Opacity .
RelativeTransform	Mendapatkan atau mengatur transformasi yang diterapkan pada kuas menggunakan koordinat relatif.
RelativeTransformProperty	Mengidentifikasi properti dependensi RelativeTransform .
Transform	Mendapatkan atau mengatur transformasi yang diterapkan pada kuas.
TransformProperty	Mengidentifikasi properti Transformasi dependensi.

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)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Menentukan properti yang dapat dianimasikan.
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Saat ditimpa di kelas turunan, menentukan properti yang dapat dianimasikan.
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika nilai lokal ditetapkan. (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

• DependencyObject
• SolidColorBrush
• Color
• Colors
• Menggunakan kuas
• Gambar dan ImageBrush
• Referensi sumber daya ResourceDictionary dan XAML