ImageBrush Kelas

Referensi

Definisi

Ruang nama:: Microsoft.UI.Xaml.Media

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.

Edit

Melukis area dengan gambar. Sumber gambar biasanya diperoleh dari format file seperti Joint Photographic Experts Group (JPEG).

public ref class ImageBrush sealed : TileBrush

/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ImageBrush final : TileBrush

[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ImageBrush : TileBrush

Public NotInheritable Class ImageBrush
Inherits TileBrush

<ImageBrush .../>

Warisan: Object Platform::Object IInspectable DependencyObject Brush TileBrush ImageBrush

Atribut: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Contoh

Contoh XAML ini menunjukkan cara mengatur properti Latar Depan TextBlock ke ImageBrush, yang gambarnya digunakan sebagai isian untuk teks yang dirender TextBlock.

<!-- TextBlock with an image brush applied to the text. -->
<TextBlock FontFamily="Verdana" FontSize="72"
 FontStyle="Italic" FontWeight="Bold">
    SHRUBBERY
  <TextBlock.Foreground>
    <ImageBrush ImageSource="forest.jpeg"/>
  </TextBlock.Foreground>
</TextBlock>

Keterangan

ImageBrush adalah jenis kuas yang mendefinisikan kontennya sebagai gambar yang dapat direntangkan dan diselaraskan secara opsional. Penggunaan untuk ImageBrush menyertakan efek dekoratif untuk teks, atau latar belakang gambar untuk kontrol atau kontainer tata letak.

Berguna untuk menggunakan ImageBrush alih-alih kontrol Gambar dalam dua skenario utama:

Anda ingin melukis area non-persegi panjang seperti elips atau batas dengan gambar
Anda ingin menggunakan satu ImageBrush untuk melukis beberapa area atau UIElements dengan gambar yang sama, yang lebih efisien daripada menggunakan beberapa kontrol Gambar

Jika Anda menentukan ImageBrush menggunakan kode, gunakan konstruktor default, lalu atur ImageBrush.ImageSource. Ini memerlukan BitmapImage (bukan Pengidentifikasi Sumber Daya Seragam (URI)) dalam kode. Jika sumber Anda adalah aliran, gunakan metode SetSourceAsync untuk menginisialisasi nilai. Jika sumber Anda adalah Pengidentifikasi Sumber Daya Seragam (URI), yang menyertakan konten dalam aplikasi Anda yang menggunakan skema ms-appx atau ms-resource , gunakan konstruktor BitmapImage yang mengambil Pengidentifikasi Sumber Daya Seragam (URI). Anda mungkin juga mempertimbangkan untuk menangani peristiwa ImageOpened jika ada masalah waktu dengan mengambil atau mendekode sumber gambar, di mana Anda mungkin memerlukan konten alternatif untuk ditampilkan hingga sumber gambar tersedia. Lihat sampel gambar XAML misalnya kode.

Catatan

Anda dapat menggunakan penanganan otomatis untuk mengakses sumber daya yang tidak memenuhi syarat dengan kualifikasi skala dan budaya saat ini, atau Anda dapat menggunakan ResourceManager dan ResourceMap dengan kualifikasi untuk budaya dan skala untuk mendapatkan sumber daya secara langsung. Untuk informasi selengkapnya lihat Sistem manajemen sumber daya.

Properti Stretch penting untuk bagaimana gambar diterapkan saat digunakan sebagai kuas. Beberapa gambar terlihat bagus ketika direntangkan seperti yang diterapkan pada properti Brush tertentu dengan perilaku Isi sedangkan gambar lain tidak meregangkan atau menskalakan dengan baik dan mungkin memerlukan nilai Tidak Ada atau Seragam untuk Stretch. Bereksperimenlah dengan nilai yang berbeda untuk Stretch untuk melihat perilaku mana yang paling terlihat saat diterapkan ke UI.

Sumber dan penskalakan gambar

Anda harus membuat sumber gambar pada beberapa ukuran yang direkomendasikan, untuk memastikan bahwa aplikasi Anda terlihat hebat saat Windows 8 menskalakannya. Saat menentukan ImageSource untuk ImageBrush, Anda dapat menggunakan konvensi penamaan yang akan secara otomatis mereferensikan sumber daya yang benar untuk penskalaan saat ini. Untuk detail konvensi penamaan dan info selengkapnya, lihat Mulai Cepat: Menggunakan sumber daya file atau gambar.

Untuk informasi selengkapnya tentang cara merancang penskalaan, lihat Panduan UX untuk tata letak dan penskalaan.

Konstruktor

ImageBrush()

Menginisialisasi instans baru kelas ImageBrush .

Properti

AlignmentX	Mendapatkan atau mengatur perataan horizontal konten dalam petak peta dasar TileBrush . (Diperoleh dari TileBrush)
AlignmentY	Mendapatkan atau mengatur perataan vertikal konten dalam petak peta dasar TileBrush . (Diperoleh dari TileBrush)
Dispatcher	Selalu kembali `null` di aplikasi SDK Aplikasi Windows. Gunakan DispatcherQueue sebagai gantinya. (Diperoleh dari DependencyObject)
DispatcherQueue	`DispatcherQueue` Mendapatkan yang dikaitkan dengan objek ini. `DispatcherQueue` mewakili fasilitas yang dapat mengakses `DependencyObject` pada utas UI bahkan jika kode dimulai oleh utas non-UI. (Diperoleh dari DependencyObject)
ImageSource	Mendapatkan atau mengatur sumber gambar yang ditampilkan oleh ImageBrush ini. Dalam kode Anda mengatur ini dengan instans subkelas ImageSource , di XAML Anda mengatur ini dengan URI ke file sumber gambar.
ImageSourceProperty	Mengidentifikasi properti dependensi ImageSource .
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)
Stretch	Mendapatkan atau menetapkan nilai yang menentukan bagaimana konten TileBrush ini membentang agar pas dengan petak petanya. (Diperoleh dari TileBrush)
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)

Acara

ImageFailed	Terjadi ketika ada kesalahan yang terkait dengan pengambilan gambar atau format.
ImageOpened	Terjadi ketika sumber gambar diunduh dan didekode tanpa kegagalan. Anda dapat menggunakan peristiwa ini untuk menentukan ukuran gambar sebelum merendernya.

Berlaku untuk

Bagikan melalui