Brush Kelas

Definisi

Ruang nama:

System.Windows.Media

Rakitan:

PresentationCore.dll

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

public ref class Brush abstract : System::Windows::Media::Animation::Animatable, IFormattable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public abstract class Brush : System.Windows.Media.Animation.Animatable, IFormattable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Brush = class
    inherit Animatable
    interface IFormattable

Public MustInherit Class Brush
Inherits Animatable
Implements IFormattable

Warisan

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

Turunan

System.Windows.Media.BitmapCacheBrush

System.Windows.Media.GradientBrush

System.Windows.Media.SolidColorBrush

System.Windows.Media.TileBrush

Atribut

TypeConverterAttribute LocalizabilityAttribute

Penerapan

IFormattable

Keterangan

" Brush Cat" atau "mengisi" area dengan outputnya. Kuas yang berbeda memiliki berbagai jenis output. Beberapa kuas melukis area dengan warna solid, yang lain dengan gradien, pola, gambar, atau gambar. Daftar berikut menjelaskan berbagai jenis kuas WPF:

• SolidColorBrush: Mengecat area dengan padat Color.

• LinearGradientBrush: Mengecat area dengan gradien linier.

• RadialGradientBrush: Mengecat area dengan gradien radial.

• ImageBrush: Mengecat area dengan gambar (diwakili oleh ImageSource objek).

• DrawingBrush: Mengecat area dengan Drawing. Gambar mungkin mencakup objek vektor dan bitmap.

• VisualBrush: Mengecat area dengan Visual objek. Memungkinkan VisualBrush Anda untuk menduplikasi konten dari satu bagian aplikasi Anda ke area lain; ini sangat berguna untuk membuat efek pantulan dan memperbesar bagian layar.

Kuas yang telah ditentukan sebelumnya

Brushes Gunakan kelas untuk melukis objek menggunakan warna solid yang telah ditentukan sebelumnya, seperti AliceBlue atau Red.

Kuas di XAML

Tabel berikut mencantumkan berbagai Brush jenis yang dapat digunakan dalam XAML dan sintaks yang didukungnya. Untuk informasi sintaks terperinci untuk kuas tertentu, lihat halaman jenis kuas tersebut.

Class	Sintaks Atribut	Sintaks Elemen Objek
SolidColorBrush	Yes	Yes
DrawingBrush	No	Yes
ImageBrush	No	Yes
LinearGradientBrush	No	Yes
RadialGradientBrush	No	Yes
VisualBrush	No	Yes

Misalnya menunjukkan cara mengecat area dengan cepat dengan warna solid, lihat Cara: Mengecat Area dengan Warna Solid.

Fitur yang Dapat Dibekukan

Kuas adalah jenis Freezable objek. Untuk informasi tentang Freezable fitur, seperti pembekuan dan kloning, lihat Gambaran Umum Objek Freezable.

Penggunaan Teks XAML

Untuk informasi XAML, lihat bagian Keterangan .

Catatan Bagi Implementer

Ketika Anda mewarisi dari Brush kelas , Anda harus mengambil alih CreateInstanceCore() metode . Bergantung pada apakah kelas Anda harus melakukan pekerjaan inisialisasi tambahan atau berisi anggota data properti non-dependensi, Anda mungkin perlu mengambil alih metode tambahan Freezable . Untuk informasi selengkapnya tentang mewarisi dari Freezable jenis, lihat Gambaran Umum Objek yang Dapat Dibekukan.

Konstruktor

Nama	Deskripsi
Brush()	Menginisialisasi instans baru dari kelas Brush.

Bidang

Nama	Deskripsi
OpacityProperty	Opacity Mengidentifikasi properti dependensi.
RelativeTransformProperty	RelativeTransform Mengidentifikasi properti dependensi.
TransformProperty	Transform Mengidentifikasi properti dependensi.

Properti

Nama	Deskripsi
CanFreeze	Mendapatkan nilai yang menunjukkan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Freezable)
DependencyObjectType	DependencyObjectType Mendapatkan yang membungkus jenis CLR instans ini. (Diperoleh dari DependencyObject)
Dispatcher	Dispatcher Mendapatkan ini DispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
HasAnimatedProperties	Mendapatkan nilai yang menunjukkan apakah satu atau beberapa AnimationClock objek dikaitkan dengan salah satu properti dependensi objek ini. (Diperoleh dari Animatable)
IsFrozen	Mendapatkan nilai yang menunjukkan apakah objek saat ini dapat dimodifikasi. (Diperoleh dari Freezable)
IsSealed	Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject)
Opacity	Mendapatkan atau mengatur tingkat keburaman dari Brush.
RelativeTransform	Mendapatkan atau mengatur transformasi yang diterapkan pada kuas menggunakan koordinat relatif.
Transform	Mendapatkan atau mengatur transformasi yang diterapkan pada kuas. Transformasi ini diterapkan setelah output kuas dipetakan dan diposisikan.

Metode

Nama	Deskripsi
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	AnimationClock Menerapkan ke DependencyProperty. Jika properti sudah dianimasikan, properti yang ditentukan HandoffBehavior akan digunakan. (Diperoleh dari Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	AnimationClock Menerapkan ke DependencyProperty. Jika properti sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan. (Diperoleh dari Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Menerapkan animasi ke yang ditentukan DependencyProperty. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, properti yang ditentukan HandoffBehavior akan digunakan. (Diperoleh dari Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Menerapkan animasi ke yang ditentukan DependencyProperty. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan. (Diperoleh dari Animatable)
CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dihapus ditentukan oleh DependencyProperty pengidentifikasi. (Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dihapus ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject)
Clone()	Membuat kloning yang dapat dimodifikasi dari ini Brush, membuat salinan mendalam dari nilai objek ini. Saat menyalin properti dependensi, metode ini menyalin referensi sumber daya dan pengikatan data (tetapi mungkin tidak lagi diselesaikan) tetapi bukan animasi atau nilainya saat ini.
CloneCore(Freezable)	Menjadikan instans sebagai kloning (salinan mendalam) dari yang ditentukan Freezable menggunakan nilai properti dasar (non-animasi). (Diperoleh dari Freezable)
CloneCurrentValue()	Membuat klon yang dapat dimodifikasi dari objek ini Brush , membuat salinan mendalam dari nilai objek ini saat ini. Referensi sumber daya, pengikatan data, dan animasi tidak disalin, tetapi nilainya saat ini.
CloneCurrentValueCore(Freezable)	Menjadikan instans sebagai klon yang dapat dimodifikasi (salinan mendalam) dari yang ditentukan Freezable menggunakan nilai properti saat ini. (Diperoleh dari Freezable)
CoerceValue(DependencyProperty)	Memaksa nilai properti dependensi yang ditentukan. Ini dilakukan dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
CreateInstance()	Menginisialisasi instans baru dari kelas Freezable. (Diperoleh dari Freezable)
CreateInstanceCore()	Saat diimplementasikan dalam kelas turunan, membuat instans baru dari kelas turunan Freezable . (Diperoleh dari Freezable)
Equals(Object)	Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject. (Diperoleh dari DependencyObject)
Freeze()	Membuat objek saat ini tidak dapat dimodifikasi dan mengatur propertinya IsFrozen ke true. (Diperoleh dari Freezable)
FreezeCore(Boolean)	Membuat objek ini Animatable tidak dapat dimodifikasi atau menentukan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Animatable)
GetAnimationBaseValue(DependencyProperty)	Mengembalikan nilai non-animasi dari yang ditentukan DependencyProperty. (Diperoleh dari Animatable)
GetAsFrozen()	Membuat salinan beku dari Freezable, menggunakan nilai properti dasar (non-animasi). Karena salinan dibekukan, sub-objek beku apa pun disalin oleh referensi. (Diperoleh dari Freezable)
GetAsFrozenCore(Freezable)	Menjadikan instans sebagai klon beku dari yang ditentukan Freezable menggunakan nilai properti dasar (non-animasi). (Diperoleh dari Freezable)
GetCurrentValueAsFrozen()	Membuat salinan beku dari Freezable menggunakan nilai properti saat ini. Karena salinan dibekukan, sub-objek beku apa pun disalin oleh referensi. (Diperoleh dari Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Menjadikan instans saat ini sebagai klon beku dari yang ditentukan Freezable. Jika objek memiliki properti dependensi animasi, nilai animasinya saat ini akan disalin. (Diperoleh dari Freezable)
GetHashCode()	Mendapatkan kode hash untuk ini DependencyObject. (Diperoleh dari DependencyObject)
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject. (Diperoleh dari DependencyObject)
InvalidateProperty(DependencyProperty)	Mengevaluasi kembali nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
OnChanged()	Dipanggil ketika objek saat ini Freezable dimodifikasi. (Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Anggota ini mendukung infrastruktur Windows Presentation Foundation (WPF) dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. (Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Memastikan bahwa penunjuk konteks yang sesuai ditetapkan untuk DependencyObjectType anggota data yang baru saja ditetapkan. (Diperoleh dari Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Mengambil alih DependencyObject implementasi OnPropertyChanged(DependencyPropertyChangedEventArgs) untuk juga memanggil handler apa pun Changed sebagai respons terhadap properti dependensi yang berubah dari jenis Freezable. (Diperoleh dari Freezable)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject)
ReadPreamble()	Memastikan bahwa Freezable sedang diakses dari utas yang valid. Pewaris Freezable harus memanggil metode ini di awal API apa pun yang membaca anggota data yang bukan properti dependensi. (Diperoleh dari Freezable)
SetCurrentValue(DependencyProperty, Object)	Mengatur nilai properti dependensi tanpa mengubah sumber nilainya. (Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya. (Diperoleh dari DependencyObject)
SetValue(DependencyPropertyKey, Object)	Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh DependencyPropertyKey pengidentifikasi properti dependensi. (Diperoleh dari DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus membuat serialisasi nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject)
ToString()	Mengembalikan representasi string dari ini Brush.
ToString(IFormatProvider)	Membuat representasi string objek ini berdasarkan informasi pemformatan khusus budaya yang ditentukan.
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
WritePostscript()	Menaikkan Changed peristiwa untuk Freezable dan memanggil metodenya OnChanged() . Kelas yang berasal dari Freezable harus memanggil metode ini di akhir API apa pun yang memodifikasi anggota kelas yang tidak disimpan sebagai properti dependensi. (Diperoleh dari Freezable)
WritePreamble()	Memverifikasi bahwa Freezable tidak dibekukan dan sedang diakses dari konteks utas yang valid. Freezable pewaris harus memanggil metode ini di awal API apa pun yang menulis ke anggota data yang bukan properti dependensi. (Diperoleh dari Freezable)

Acara

Nama	Deskripsi
Changed	Terjadi ketika atau objek yang Freezable dikandungnya dimodifikasi. (Diperoleh dari Freezable)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IFormattable.ToString(String, IFormatProvider)	Memformat nilai instans saat ini menggunakan format yang ditentukan.

Lihat juga

• Brushes
• Sampel Kuas