LinearGradientBrush Kelas

Definisi

Ruang nama:

Windows.UI.Xaml.Media

Mengecat area dengan gradien linier.

public ref class LinearGradientBrush sealed : GradientBrush

/// [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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Xaml.Media.ILinearGradientBrushFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class LinearGradientBrush final : GradientBrush

[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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Xaml.Media.ILinearGradientBrushFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LinearGradientBrush : GradientBrush

Public NotInheritable Class LinearGradientBrush
Inherits GradientBrush

<LinearGradientBrush ...>
  oneOrMoreGradientStops
</LinearGradientBrush

Warisan

Object Platform::Object IInspectable DependencyObject Brush GradientBrush LinearGradientBrush

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

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

Contoh

Contoh ini membuat gradien linier dengan empat warna dan menggunakannya untuk melukis Persegi Panjang.

<StackPanel>
  <!-- This rectangle is painted with a vertical linear gradient. -->
  <Rectangle Width="200" Height="100">
    <Rectangle.Fill>
      <LinearGradientBrush StartPoint="0.5,0" EndPoint="0.5,1">
        <GradientStop Color="Yellow" Offset="0.0" />
        <GradientStop Color="Red" Offset="0.25" />
        <GradientStop Color="Blue" Offset="0.75" />
        <GradientStop Color="LimeGreen" Offset="1.0" />
      </LinearGradientBrush>
    </Rectangle.Fill>
  </Rectangle>
</StackPanel>

Keterangan

LinearGradientBrush adalah jenis Brush yang digunakan untuk banyak kemungkinan properti UI yang menggunakan Brush untuk mengisi beberapa atau semua area visual objek di UI aplikasi. Contoh beberapa properti yang paling umum digunakan yang menggunakan nilai Kuas meliputi: Control.Background, Control.Foreground, Shape.Fill, Control.BorderBrush, Panel.Background, TextBlock.Foreground. LinearGradientBrush adalah alternatif untuk jenis SolidColorBrush yang lebih umum digunakan.

Properti StartPoint dan EndPoint linearGradientBrush menjelaskan dua titik dalam ruang koordinat relatif. Ini menciptakan orientasi untuk gradien, dan biasanya ini menentukan gradien horizontal, atau gradien vertikal. Gradien diagonal juga dapat digunakan. LinearGradientBrush biasanya memiliki dua atau lebih nilai GradientStop untuk properti GradientStops (koleksi yang diurutkan). Setiap GradientStop menentukan Warna dan Offset. Offset mewakili posisi antara 0 ( StartPoint) dan 1 ( Titik Akhir) di sepanjang gradien, dan panjang piksel aktual kuas dan gradiennya disesuaikan berdasarkan UI tempat Anda menerapkan LinearGradientBrush sebagai nilai. Untuk informasi selengkapnya tentang bagaimana nilai Offset ditentukan dan bagaimana Offset, StartPoint dan EndPoint terkait, lihat Menggunakan kuas. Adalah umum untuk digunakan

Anda dapat menggunakan nilai Transparan untuk salah satu warna GradientStop . Meskipun ini tidak secara visual menerapkan perubahan apa pun pada UI (transparan), titik tersebut dapat dideteksi untuk tujuan pengujian temuan. Untuk informasi selengkapnya tentang pengujian hit, lihat bagian "Uji" interaksi Mouse.

Nilai GradientStop dari LinearGradientBrush dapat dianimasikan sebagai bagian dari transisi atau animasi dekoratif. Gunakan salah satu jenis animasi khusus yang dapat menganimasikan nilai Warna . Ini biasanya melibatkan menjadi .(GradientStop.Color) bagian dari jalur properti yang lebih panjang untuk nilai Storyboard.TargetProperty . Untuk informasi selengkapnya tentang penargetan properti dan cara menganimasikan properti yang menggunakan nilai Brush , lihat Animasi storyboarded.

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 Windows Runtime XAML, Anda akan melihat bahwa templat menggunakan sumber daya kuas secara ekstensif (meskipun ini biasanya SolidColorBrush, bukan LinearGradientBrush). 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.

Konstruktor

LinearGradientBrush()	Menginisialisasi instans baru kelas LinearGradientBrush .
LinearGradientBrush(GradientStopCollection, Double)	Menginisialisasi instans baru kelas LinearGradientBrush yang memiliki GradientStopCollection dan sudut yang ditentukan.

Properti

ColorInterpolationMode	Mendapatkan atau mengatur nilai enumerasi ColorInterpolationMode yang menentukan bagaimana warna gradien diinterpolasi. (Diperoleh dari GradientBrush)
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)
EndPoint	Mendapatkan atau mengatur koordinat dua dimensi akhir dari gradien linier.
EndPointProperty	Mengidentifikasi properti dependensi EndPoint .
GradientStops	Mendapatkan atau mengatur gradien sikat berhenti. (Diperoleh dari GradientBrush)
MappingMode	Mendapatkan atau menetapkan nilai enumerasi BrushMappingMode yang menentukan apakah koordinat posisi sikat gradien absolut atau relatif terhadap area output. (Diperoleh dari GradientBrush)
Opacity	Mendapatkan atau menetapkan tingkat keburaman kuas. (Diperoleh dari Brush)
RelativeTransform	Mendapatkan atau mengatur transformasi yang diterapkan pada kuas menggunakan koordinat relatif. (Diperoleh dari Brush)
SpreadMethod	Mendapatkan atau mengatur jenis metode penyebaran yang menentukan cara menggambar gradien yang dimulai atau berakhir di dalam batas objek yang akan dicat. (Diperoleh dari GradientBrush)
StartPoint	Mendapatkan atau mengatur koordinat dua dimensi awal gradien linier.
StartPointProperty	Mengidentifikasi properti dependensi StartPoint .
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)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Menentukan properti yang dapat dianimasikan. (Diperoleh dari Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Saat ditimpa di kelas turunan, menentukan properti yang dapat dianimasikan. (Diperoleh dari Brush)
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

• GradientBrush
• SolidColorBrush
• RadialGradientBrush
• Menggunakan kuas
• Referensi sumber daya ResourceDictionary dan XAML