Brush Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendefinisikan objek yang digunakan untuk melukis objek grafis. Kelas yang berasal dari Brush menggambarkan bagaimana area dicat.
public ref class Brush : DependencyObject
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
/// [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
[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
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
- Turunan
- Atribut
- Penerapan
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) |