Bagikan melalui


Image Kelas

Definisi

Mewakili kontrol yang menampilkan gambar. Sumber gambar ditentukan dengan merujuk ke file gambar, menggunakan beberapa format yang didukung. Sumber gambar juga dapat diatur dengan aliran. Lihat Keterangan untuk daftar format sumber gambar yang didukung.

public ref class Image sealed : FrameworkElement
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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 Image final : FrameworkElement
/// [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")]
class Image final : FrameworkElement
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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 sealed class Image : FrameworkElement
[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")]
public sealed class Image : FrameworkElement
Public NotInheritable Class Image
Inherits FrameworkElement
<Image .../>
Warisan
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement Image
Atribut

Persyaratan Windows

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

Contoh

Tip

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat Gambar.

Aplikasi WinUI 2 Gallery mencakup contoh interaktif sebagian besar kontrol, fitur, dan fungsi WinUI 2. Dapatkan aplikasi dari Microsoft Store atau dapatkan kode sumber di GitHub.

Keterangan

Format file gambar

Gambar dapat menampilkan format file gambar ini:

  • Joint Photographic Experts Group (JPEG)
  • Grafik Jaringan Portabel (PNG)
  • bitmap (BMP)
  • Graphics Interchange Format (GIF)
  • Format File Gambar Bertag (TIFF)
  • JPEG XR
  • ikon (ICO)
  • Grafik Vektor Yang Dapat Diskalakan (SVG)

Catatan

File ikon hanya didukung pada Windows. Tidak didukung pada Windows Phone 8.1

Mulai Windows 10, versi 1607, elemen Gambar mendukung gambar Graphics Interchange Format (GIF) animasi. Saat Anda menggunakan BitmapImage sebagai Sumber gambar, Anda dapat mengakses BITMAPImage API untuk mengontrol pemutaran gambar Graphics Interchange Format (GIF) animasi. Untuk informasi selengkapnya, lihat Komentar di halaman kelas BitmapImage .

Catatan

Dukungan Animated Graphics Interchange Format (GIF) tersedia saat aplikasi Anda dikompilasi untuk Windows 10, versi 1607, dan berjalan pada versi 1607 (atau yang lebih baru). Saat aplikasi Anda dikompilasi untuk atau berjalan pada versi sebelumnya, bingkai pertama Graphics Interchange Format (GIF) ditampilkan, tetapi tidak dianimasikan.

Mulai Windows 10, versi 1703, elemen Gambar mendukung gambar Scalable Vector Graphics (SVG) statis melalui SvgImageSource. SvgImageSource mendukung mode statis aman dari spesifikasi SVG dan tidak mendukung animasi atau interaksi. Direct2D menyediakan dukungan penyajian SVG yang mendasar dan untuk informasi selengkapnya tentang elemen SVG tertentu dan dukungan atribut, lihat Dukungan SVG. Untuk mempelajari selengkapnya tentang cara menyisipkan SVG di aplikasi Anda, kunjungi halaman kelas SvgImageSource .

Catatan

Dukungan Scalable Vector Graphics (SVG) tersedia saat aplikasi Anda dikompilasi untuk Windows 10, versi 1703, dan berjalan pada versi 1703 (atau yang lebih baru). Saat aplikasi Anda dikompilasi untuk atau berjalan pada versi sebelumnya, gambar SVG tidak akan ditampilkan.

Mengatur Image.Source

Untuk mengatur file sumber gambar yang ditampilkan Gambar, Anda mengatur properti Sumbernya , baik di XAML atau dalam kode. Berikut adalah contoh sederhana pengaturan Sumber di XAML:

<Image Width="200" Source="Images/myimage.png"/>

Penggunaan ini mengatur Source by Uniform Resource Identifier (URI), yang merupakan pintasan yang diaktifkan oleh XAML. Perhatikan bahwa Pengidentifikasi Sumber Daya Seragam (URI) di sini tampaknya merupakan Pengidentifikasi Sumber Daya Seragam (URI) relatif; mendukung Pengidentifikasi Sumber Daya Seragam Parsial (URI) adalah pintasan XAML lainnya. Akar Pengidentifikasi Sumber Daya Seragam (URI) ini adalah folder dasar untuk proyek aplikasi. Ini biasanya lokasi yang sama dengan file XAML yang berisi tag Gambar dimuat. Dalam contoh ini, file sumber gambar berada dalam subfolder Gambar dalam struktur file aplikasi.

Mengatur properti Sumber secara inheren adalah tindakan asinkron. Karena ini adalah properti , tidak ada sintaks yang dapat ditunggu, tetapi untuk sebagian besar skenario Anda tidak perlu berinteraksi dengan aspek asinkron pemuatan gambar. Kerangka kerja akan menunggu sumber gambar dikembalikan, dan akan memulai siklus tata letak saat file sumber gambar tersedia dan didekode.

Mengatur sumber ke nilai Pengidentifikasi Sumber Daya Seragam (URI) yang tidak dapat diselesaikan ke file sumber gambar yang valid tidak memberikan pengecualian. Sebaliknya, ia menembakkan peristiwa ImageFailed . Anda dapat menulis handler ImageFailed dan melampirkannya ke objek Gambar, dan mungkin menggunakan ErrorMessage dalam data peristiwa untuk menentukan sifat kegagalan. Kesalahan dalam pendekodean juga dapat mengaktifkan ImageFailed. Jika Anda ingin memverifikasi bahwa file sumber gambar dimuat dengan benar, Anda dapat menangani peristiwa ImageOpened pada elemen Gambar.

Anda biasanya menggunakan file sumber gambar yang telah Anda sertakan sebagai bagian dari paket unduhan aplikasi Anda. Untuk file besar, mungkin ada penundaan yang sangat kecil saat file sumber gambar didekodekan, jika ini pertama kalinya sumber digunakan. Untuk informasi selengkapnya tentang sumber daya aplikasi dan cara mengemas file sumber gambar dalam paket aplikasi, lihat Menentukan sumber daya aplikasi.

Anda juga dapat menggunakan file sumber gambar yang bukan bagian dari aplikasi, misalnya gambar dari server eksternal. Gambar-gambar ini diunduh oleh permintaan HTTP internal, lalu didekodekan. Jika file sumber gambar adalah file besar, atau jika ada masalah koneksi, mungkin ada penundaan sebelum gambar eksternal dapat ditampilkan dalam elemen Gambar.

Mengatur Image.Source menggunakan kode

Jika Anda membuat objek Gambar menggunakan kode, panggil konstruktor default, lalu atur properti Image.Source . Mengatur properti Image.Source memerlukan instans kelas BitmapImage , yang juga harus Anda buat. Jika sumber gambar Anda adalah file yang direferensikan oleh Pengidentifikasi Sumber Daya Seragam (URI), gunakan konstruktor BitmapImage yang mengambil parameter Pengidentifikasi Sumber Daya Seragam (URI). Saat mereferensikan konten lokal, Anda harus menyertakan skema ms-appx: dalam Pengidentifikasi Sumber Daya Seragam (URI) absolut yang Anda gunakan sebagai parameter konstruktor BitmapImage . Dalam kode, Anda tidak mendapatkan pintasan pemrosesan untuk menggabungkan bagian Pengidentifikasi Sumber Daya Seragam (URI) relatif dan skema ms-appx: yang terjadi secara otomatis jika Anda menentukan Sumber sebagai atribut XAML. Sebagai gantinya, Anda harus secara eksplisit membuat Pengidentifikasi Sumber Daya Seragam (URI) absolut dengan skema yang sesuai. Anda biasanya menggunakan skema ms-appx: untuk file gambar yang dikemas sebagai bagian dari aplikasi Anda.

Tip

Jika Anda menggunakan C# atau Microsoft Visual Basic, Anda bisa mendapatkan properti BaseUri Gambar, dan meneruskan itu sebagai parameter baseUri untuk konstruktor System.Uri yang menggabungkan lokasi dasar Pengidentifikasi Sumber Daya Seragam (URI) dan jalur relatif dalam lokasi tersebut.

Berikut adalah contoh pengaturan Image.Source di C#. Dalam contoh ini, objek Gambar dibuat di XAML tetapi tidak memiliki sumber atau nilai properti lainnya; sebaliknya nilai-nilai ini disediakan pada run-time ketika Gambar dimuat dari XAML.

void Image_Loaded(object sender, RoutedEventArgs e)
{
    Image img = sender as Image; 
    BitmapImage bitmapImage = new BitmapImage();
    img.Width = bitmapImage.DecodePixelWidth = 80; //natural px width of image source
    // don't need to set Height, system maintains aspect ratio, and calculates the other
    // dimension, so long as one dimension measurement is provided
    bitmapImage.UriSource = new Uri(img.BaseUri,"Assets/StoreLogo.png");
    img.Source = bitmapImage;
}

Menggunakan sumber aliran untuk sumber Gambar

Jika sumber gambar Anda adalah aliran, Anda harus menulis kode yang mengatur instans Gambar Anda untuk menggunakan aliran. Ini tidak dapat dilakukan di XAML saja. Buat Gambar untuk digunakan, atau referensikan instans Gambar yang ada (yang mungkin telah ditentukan dalam markup XAML, tetapi tanpa sumber). Kemudian gunakan metode Async SetSourceAsyncbitmapImage untuk menentukan informasi gambar dari aliran, melewati aliran untuk digunakan sebagai parameter streamSource . Menggunakan aliran untuk sumber gambar cukup umum. Misalnya, jika aplikasi Anda memungkinkan pengguna untuk memilih file gambar menggunakan kontrol FileOpenPicker , objek yang Anda dapatkan yang mewakili file yang dipilih pengguna dapat dibuka sebagai aliran, tetapi tidak menyediakan referensi Pengidentifikasi Sumber Daya Seragam (URI) ke file.

Dalam contoh ini, kode sudah dapat ditunggu karena menunggu pengguna memilih file dan hanya berjalan setelah itu terjadi. Aliran yang akan digunakan berasal dari StorageFile.OpenAsync setelah instans StorageFile dikembalikan dari tindakan pemilih asinkron.

FileOpenPicker open = new FileOpenPicker(); 
// Open a stream for the selected file 
StorageFile file = await open.PickSingleFileAsync(); 
// Ensure a file was selected 
if (file != null) 
{ 
    using (IRandomAccessStream fileStream = await file.OpenAsync(Windows.Storage.FileAccessMode.Read)) 
    { 
        // Set the image source to the selected bitmap 
         BitmapImage bitmapImage = new BitmapImage(); 
         bitmapImage.DecodePixelWidth = 600; //match the target Image.Width, not shown
         await bitmapImage.SetSourceAsync(fileStream); 
         Scenario2Image.Source = bitmapImage; 
    } 
}

Tip

Jika Anda menggunakan C# atau Microsoft Visual Basic, aliran dapat menggunakan jenis System.IO.Stream yang mungkin Anda kenal dari pengalaman pemrograman Microsoft .NET sebelumnya. Anda dapat memanggil metode ekstensi AsStream sebagai metode instans pada objek jenis IRandomAccessStream apa pun yang telah Anda peroleh dari WINDOWS Runtime API. Contoh sebelumnya menggunakan IRandomAccessStream untuk melewati parameter dan tidak perlu menggunakan AsStream. Tetapi jika Anda perlu memanipulasi aliran, AsStream ada sebagai utilitas untuk mengonversi ke System.IO.Stream jika Anda membutuhkannya.

Lihat sampel gambar XAML untuk contoh kode lainnya.

File dan performa gambar

File gambar besar dapat memengaruhi performa karena dimuat ke dalam memori. Jika Anda mereferensikan file gambar di mana Anda tahu bahwa file sumber adalah gambar beresolusi tinggi yang besar, tetapi aplikasi Anda menampilkannya di wilayah UI yang lebih kecil dari ukuran alami gambar, Anda harus mengatur properti DecodePixelWidth , atau DecodePixelHeight. Properti DecodePixel* memungkinkan Anda meneruskan informasi langsung ke codec khusus format, dan codec dapat menggunakan informasi ini untuk mendekode secara lebih efisien dan ke jejak memori yang lebih kecil. Atur DecodePixelWidth ke lebar piksel yang sama dengan area yang Anda inginkan untuk benar-benar ditampilkan oleh aplikasi Anda. Dengan kata lain, DecodePixelWidth untuk sumber BitmapImage harus bernilai sama dengan Width atau ActualWidth dari kontrol Gambar yang menampilkan sumber tersebut.

Anda dapat mengatur DecodePixelWidth, atau mengatur DecodePixelHeight. Jika Anda mengatur salah satu dari dua properti ini, sistem menghitung properti yang cocok untuk mempertahankan rasio aspek yang benar. Anda juga dapat mengatur kedua properti, tetapi biasanya Anda harus menggunakan nilai yang mempertahankan rasio aspek tersebut. Jika Anda ingin mengubah rasio aspek ada cara yang lebih baik untuk melakukannya, misalnya menggunakan TranslateTransform sebagai RenderTransform.

Untuk mengatur DecodePixelWidth (atau DecodePixelHeight) di XAML, Anda harus menggunakan sintaks XAML yang sedikit lebih verbose yang menyertakan elemen BitmapImage eksplisit sebagai nilai elemen properti, seperti ini:

<Image>
  <Image.Source>
    <BitmapImage DecodePixelWidth="200" UriSource="images/myimage.png"/>
  </Image.Source>
</Image>

DecodePixelWidth (atau DecodePixelHeight) adalah properti BitmapImage, jadi Anda memerlukan elemen objek BitmapImage XAML eksplisit untuk mengatur properti DecodePixel* sebagai atribut di XAML.

Jika Anda membuat instans Gambar dalam kode, Anda mungkin sudah membuat instans BitmapImage sebagai nilai yang akan disediakan untuk properti Sumber , jadi cukup atur DecodePixelWidth (atau DecodePixelHeight) pada instans BitmapImage sebelum Anda mengatur properti UriSource . Properti DecodePixelType juga memengaruhi bagaimana nilai piksel ditafsirkan oleh operasi dekode.

Untuk mencegah gambar didekode lebih dari sekali, tetapkan properti sumber gambar dari Pengidentifikasi Sumber Daya Seragam (URI) daripada menggunakan aliran memori kapan pun Anda bisa. Kerangka kerja XAML dapat mengaitkan Pengidentifikasi Sumber Daya Seragam (URI) yang sama di beberapa tempat dengan satu gambar yang didekodekan, tetapi tidak dapat melakukan hal yang sama untuk beberapa aliran memori meskipun berisi data yang sama.

Anda dapat menghapus file gambar dari cache gambar dengan mengatur semua nilai Image.Source terkait ke null.

Untuk informasi selengkapnya tentang kelas dan performa Gambar, lihat Mengoptimalkan animasi dan media.

Pengodean dan pendekodean file gambar

Dukungan codec yang mendasari untuk file gambar disediakan oleh WINDOWS Imaging Component (WIC) API. Untuk informasi selengkapnya tentang format gambar tertentu seperti yang didokumenkan untuk codec, lihat Codec WIC Asli.

API untuk Gambar, BitmapImage , dan BitmapSource tidak menyertakan metode khusus untuk pengodean dan pendekodean format media. Semua operasi pendekodean adalah bawaan sebagai tindakan yang terjadi saat sumber diatur atau direset. Ini membuat kelas lebih mudah digunakan untuk membangun UI, karena memiliki serangkaian format file sumber dan perilaku pendekodean yang didukung secara default. Kelas seperti BitmapImage mengekspos beberapa opsi pendekodean dan logika sebagai bagian dari data peristiwa untuk peristiwa ImageOpened atau ImageFailed . Jika Anda memerlukan pendekodean file gambar tingkat lanjut, atau pengodean gambar, Anda harus menggunakan API dari namespace Windows.Graphics.Imaging . Anda mungkin memerlukan API ini jika skenario aplikasi Anda melibatkan konversi format file gambar, atau manipulasi gambar tempat pengguna dapat menyimpan hasilnya sebagai file. API pengodean juga didukung oleh komponen Komponen Pencitraan Windows (WIC) Windows.

Lebar dan tinggi gambar

Kelas Gambar mewarisi properti Lebar dan Tinggi dari FrameworkElement, dan properti ini berpotensi mengontrol ukuran yang akan dirender kontrol Gambar Anda saat ditampilkan di UI. Jika Anda tidak mengatur Lebar atau Tinggi, lebar dan tinggi ditentukan oleh ukuran alami sumber gambar. Misalnya, jika Anda memuat gambar bitmap dengan lebar 300 piksel dan lebar 400 piksel, seperti yang direkam dalam format file sumbernya, pengukuran ini digunakan untuk lebar dan tinggi saat kontrol Gambar menghitung ukuran alaminya. Anda dapat memeriksa ActualHeight dan ActualWidth pada durasi setelah gambar dirender untuk mendapatkan informasi pengukuran. Atau, Anda dapat menangani ImageOpened dan memeriksa properti file gambar seperti PixelHeight dan PixelWidth segera sebelum gambar dirender.

Jika Anda hanya mengatur salah satu properti Lebar atau Tinggi tetapi tidak keduanya, maka sistem dapat menggunakan dimensi tersebut sebagai panduan dan menghitung yang lain, mempertahankan rasio aspek. Jika Anda tidak yakin dengan dimensi file sumber, pilih dimensi yang paling penting untuk dikontrol dalam skenario tata letak Anda dan biarkan sistem menghitung dimensi lain, lalu perilaku tata letak kontainer biasanya akan menyesuaikan tata letak agar pas.

Jika Anda tidak mengatur Lebar dan/atau Tinggi, dan membiarkan gambar sebagai ukuran alaminya, properti Stretch untuk gambar dapat mengontrol bagaimana file sumber gambar akan mengisi ruang yang Anda tentukan sebagai Lebar dan Tinggi. Nilai Stretch default adalah Uniform, yang mempertahankan rasio aspek saat cocok dengan gambar ke dalam kontainer tata letak. Jika dimensi kontainer tidak memiliki rasio aspek yang sama, maka akan ada ruang kosong yang masih menjadi bagian dari Gambar tetapi tidak menampilkan piksel gambar apa pun, setidaknya saat menggunakan nilai Seragam untuk Stretch. UniformToFill untuk Stretch tidak akan meninggalkan ruang kosong tetapi mungkin mengklip gambar jika dimensi berbeda. Isi untuk Stretch tidak akan meninggalkan ruang kosong, tetapi mungkin mengubah rasio aspek. Anda dapat bereksperimen dengan nilai-nilai ini untuk melihat apa yang terbaik untuk tampilan gambar dalam skenario tata letak Anda. Selain itu, ketahuilah bahwa kontainer tata letak tertentu mungkin mengukur gambar yang tidak memiliki Lebar dan Tinggi tertentu untuk mengisi seluruh ruang tata letak, dalam hal ini Anda dapat memilih untuk mengatur ukuran tertentu pada gambar atau kontainer untuk itu.

NineGrid

Menggunakan teknik NineGrid adalah opsi lain untuk mengukur gambar yang memiliki ukuran alami yang berbeda dari area tampilan Anda, jika gambar memiliki wilayah yang tidak boleh diskalakan secara seragam. Misalnya Anda dapat menggunakan gambar latar belakang yang memiliki batas melekat yang seharusnya hanya membentang dalam satu dimensi, dan sudut yang tidak boleh membentang sama sekali, tetapi pusat gambar dapat membentang agar sesuai dengan persyaratan tata letak di kedua dimensi. Untuk informasi selengkapnya, lihat NineGrid.

Kualifikasi dan pelokalan sumber daya untuk Gambar

File sumber gambar dan penskalakan

Anda harus membuat sumber gambar pada beberapa ukuran yang direkomendasikan, untuk memastikan bahwa aplikasi Anda terlihat hebat saat Windows 8 menskalakannya. Saat menentukan Sumber untuk Gambar, Anda dapat menggunakan konvensi penamaan untuk sumber daya yang akan menggunakan sumber daya yang benar untuk faktor penskalaan khusus perangkat. Ini ditentukan oleh aplikasi secara otomatis pada run-time. Untuk detail konvensi penamaan yang akan digunakan dan info selengkapnya, lihat Mulai Cepat: Menggunakan sumber daya file atau gambar.

Untuk informasi selengkapnya tentang cara mendesain gambar dengan benar untuk penskalaan, lihat Panduan UX untuk tata letak dan penskalaan.

Menggunakan sumber daya yang tidak memenuhi syarat

Sumber daya yang tidak memenuhi syarat adalah teknik yang dapat Anda gunakan di mana referensi sumber daya dasar mengacu pada sumber daya default, dan proses manajemen sumber daya dapat menemukan sumber daya yang setara secara otomatis. 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.

FlowDirection untuk Gambar

Jika Anda mengatur FlowDirection sebagai RightToLeft untuk Gambar, konten visual Gambar dibalik secara horizontal. Namun, elemen Gambar tidak mewarisi nilai FlowDirection dari elemen induk apa pun. Biasanya Anda hanya ingin perilaku membalik gambar dalam gambar yang relevan dengan tata letak, tetapi belum tentu untuk elemen yang memiliki teks yang disematkan atau komponen lain yang tidak masuk akal dibalik untuk audiens kanan ke kiri. Untuk mendapatkan perilaku membalik gambar, Anda harus mengatur elemen FlowDirection pada elemen Gambar khusus ke RightToLeft, atau mengatur properti FlowDirection di kode di belakang. Pertimbangkan untuk mengidentifikasi elemen Gambar dengan direktif x:Uid, dan tentukan nilai FlowDirection sebagai sumber daya Windows Runtime, sehingga pakar pelokalan Anda dapat mengubah nilai ini nanti tanpa mengubah XAML atau kode.

Kelas dan aksesibilitas Gambar

Kelas Gambar bukan kelas kontrol sejati karena bukan kelas kontrol turunan. Anda tidak dapat memanggil fokus ke elemen Gambar, atau menempatkan elemen Gambar dalam urutan tab. Untuk informasi selengkapnya tentang aspek aksesibilitas menggunakan gambar dan elemen Gambar di UI Anda, lihat Informasi aksesibilitas dasar.

Perilaku Windows 8

Untuk Windows 8, sumber daya dapat menggunakan pola kualifikasi sumber daya untuk memuat sumber daya yang berbeda tergantung pada penskalaan khusus perangkat. Namun, sumber daya tidak dimuat ulang secara otomatis jika faktor penskalakan berubah saat aplikasi berjalan. Dalam hal ini aplikasi harus mengurus memuat ulang sumber daya, dengan menangani peristiwa DpiChanged (atau peristiwa LogicalDpiChanged yang tidak digunakan lagi) dan menggunakan RESOURCEManager API untuk memuat ulang sumber daya yang sesuai untuk faktor penskalaan baru secara manual. Dimulai dengan Windows 8.1, sumber daya apa pun yang awalnya diambil untuk aplikasi Anda secara otomatis dievaluasi ulang jika faktor penskalaan berubah saat aplikasi berjalan. Selain itu, ketika sumber daya tersebut adalah sumber gambar untuk objek Gambar, maka salah satu peristiwa pemuatan sumber (ImageOpened atau ImageFailed) diaktifkan sebagai akibat dari tindakan sistem meminta sumber daya baru dan kemudian menerapkannya ke Gambar. Skenario di mana perubahan skala run-time mungkin terjadi adalah jika pengguna memindahkan aplikasi Anda ke monitor yang berbeda saat lebih dari satu tersedia.

Jika Anda memigrasikan kode aplikasi dari Windows 8 ke Windows 8.1, Anda mungkin ingin memperhitungkan perubahan perilaku ini, karena menghasilkan peristiwa ImageOpened atau ImageFailed yang terjadi pada run-time saat perubahan skala ditangani, bahkan dalam kasus di mana Sumber diatur dalam XAML. Selain itu, jika Anda memiliki kode yang menangani DpiChanged/LogicalDpiChanged dan mengatur ulang sumber daya, Anda harus memeriksa apakah kode tersebut masih diperlukan mengingat perilaku pemuatan ulang otomatis Windows 8.1 yang baru.

Aplikasi yang dikompilasi untuk Windows 8 tetapi berjalan di Windows 8.1 terus menggunakan perilaku Windows 8.

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1607 14393 GetAlphaMask

Konstruktor

Image()

Menginisialisasi instans baru kelas Gambar .

Properti

AccessKey

Mendapatkan atau mengatur kunci akses (mnemonic) untuk elemen ini.

(Diperoleh dari UIElement)
AccessKeyScopeOwner

Mendapatkan atau mengatur elemen sumber yang menyediakan cakupan kunci akses untuk elemen ini, meskipun tidak berada di pohon visual elemen sumber.

(Diperoleh dari UIElement)
ActualHeight

Mendapatkan tinggi FrameworkElement yang dirender. Lihat Keterangan.

(Diperoleh dari FrameworkElement)
ActualOffset

Mendapatkan posisi UIElement ini, relatif terhadap induknya, dihitung selama lulus pengaturan proses tata letak.

(Diperoleh dari UIElement)
ActualSize

Mendapatkan ukuran yang dihitung UIElement ini selama proses penyusunan tata letak.

(Diperoleh dari UIElement)
ActualTheme

Mendapatkan tema UI yang saat ini digunakan oleh elemen , yang mungkin berbeda dari RequestedTheme.

(Diperoleh dari FrameworkElement)
ActualWidth

Mendapatkan lebar frameworkElement yang dirender. Lihat Keterangan.

(Diperoleh dari FrameworkElement)
AllowDrop

Mendapatkan atau menetapkan nilai yang menentukan apakah UIElement ini dapat menjadi target penurunan untuk tujuan operasi seret dan letakkan.

(Diperoleh dari UIElement)
AllowFocusOnInteraction

Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen secara otomatis mendapatkan fokus saat pengguna berinteraksi dengannya.

(Diperoleh dari FrameworkElement)
AllowFocusWhenDisabled

Mendapatkan atau mengatur apakah kontrol yang dinonaktifkan dapat menerima fokus.

(Diperoleh dari FrameworkElement)
BaseUri

Mendapatkan Pengidentifikasi Sumber Daya Seragam (URI) yang mewakili Pengidentifikasi Sumber Daya Seragam (URI) dasar untuk objek yang dibangun XAML pada waktu pemuatan XAML. Properti ini berguna untuk resolusi Pengidentifikasi Sumber Daya Seragam (URI) pada durasi.

(Diperoleh dari FrameworkElement)
CacheMode

Mendapatkan atau menetapkan nilai yang menunjukkan bahwa konten yang dirender harus di-cache sebagai bitmap yang dikomposisikan jika memungkinkan.

(Diperoleh dari UIElement)
CanBeScrollAnchor

Mendapatkan atau menetapkan nilai yang menunjukkan apakah UIElement dapat menjadi kandidat untuk penahanan gulir.

(Diperoleh dari UIElement)
CanDrag

Mendapatkan atau mengatur nilai yang menunjukkan apakah elemen dapat diseret sebagai data dalam operasi seret dan letakkan.

(Diperoleh dari UIElement)
CenterPoint

Mendapatkan atau mengatur titik tengah elemen, yang merupakan titik di mana rotasi atau penskalaan terjadi. Mempengaruhi posisi penyajian elemen.

(Diperoleh dari UIElement)
Clip

Mendapatkan atau mengatur RectangleGeometry yang digunakan untuk menentukan kerangka konten UIElement.

(Diperoleh dari UIElement)
CompositeMode

Mendapatkan atau mengatur properti yang mendeklarasikan komposisi alternatif dan mode perpaduan untuk elemen dalam tata letak dan jendela induknya. Ini relevan untuk elemen yang terlibat dalam UI XAML campuran / Microsoft DirectX.

(Diperoleh dari UIElement)
ContextFlyout

Mendapatkan atau mengatur flyout yang terkait dengan elemen ini.

(Diperoleh dari UIElement)
DataContext

Mendapatkan atau mengatur konteks data untuk FrameworkElement. Penggunaan umum konteks data adalah ketika FrameworkElement menggunakan ekstensi markup {Binding} dan berpartisipasi dalam pengikatan data.

(Diperoleh dari FrameworkElement)
DesiredSize

Mendapatkan ukuran yang dihitung UIElement ini selama pengukuran lulus dari proses tata letak.

(Diperoleh dari UIElement)
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)
ExitDisplayModeOnAccessKeyInvoked

Mendapatkan atau mengatur nilai yang menentukan apakah tampilan kunci akses ditutup saat kunci akses dipanggil.

(Diperoleh dari UIElement)
FlowDirection

Mendapatkan atau mengatur arah di mana teks dan elemen UI lainnya mengalir dalam elemen induk apa pun yang mengontrol tata letaknya. Properti ini dapat diatur ke LeftToRight atau RightToLeft. Mengatur FlowDirection ke RightToLeft pada elemen apa pun mengatur perataan ke kanan, urutan baca ke kanan-ke-kiri dan tata letak kontrol untuk mengalir dari kanan ke kiri.

(Diperoleh dari FrameworkElement)
FocusVisualMargin

Mendapatkan atau mengatur margin luar visual fokus untuk FrameworkElement.

(Diperoleh dari FrameworkElement)
FocusVisualPrimaryBrush

Mendapatkan atau mengatur kuas yang digunakan untuk menggambar batas HighVisibility luar visual atau Reveal fokus untuk FrameworkElement.

(Diperoleh dari FrameworkElement)
FocusVisualPrimaryThickness

Mendapatkan atau mengatur ketebalan batas HighVisibility luar visual atau Reveal fokus untuk FrameworkElement.

(Diperoleh dari FrameworkElement)
FocusVisualSecondaryBrush

Mendapatkan atau mengatur kuas yang digunakan untuk menggambar batas HighVisibility dalam visual atau Reveal fokus untuk FrameworkElement.

(Diperoleh dari FrameworkElement)
FocusVisualSecondaryThickness

Mendapatkan atau mengatur ketebalan batas HighVisibility dalam visual atau Reveal fokus untuk FrameworkElement.

(Diperoleh dari FrameworkElement)
Height

Mendapatkan atau mengatur tinggi frameworkElement yang disarankan.

(Diperoleh dari FrameworkElement)
HighContrastAdjustment

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kerangka kerja secara otomatis menyesuaikan properti visual elemen saat tema kontras tinggi diaktifkan.

(Diperoleh dari UIElement)
HorizontalAlignment

Mendapatkan atau mengatur karakteristik perataan horizontal yang diterapkan ke FrameworkElement saat disusun dalam induk tata letak, seperti kontrol panel atau item.

(Diperoleh dari FrameworkElement)
IsAccessKeyScope

Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen menentukan cakupan kunci aksesnya sendiri.

(Diperoleh dari UIElement)
IsDoubleTapEnabled

Mendapatkan atau menetapkan nilai yang menentukan apakah peristiwa DoubleTapped dapat berasal dari elemen tersebut.

(Diperoleh dari UIElement)
IsHitTestVisible

Mendapatkan atau mengatur apakah area yang terkandung dari UIElement ini dapat mengembalikan nilai true untuk pengujian hit.

(Diperoleh dari UIElement)
IsHoldingEnabled

Mendapatkan atau menetapkan nilai yang menentukan apakah peristiwa Holding dapat berasal dari elemen tersebut.

(Diperoleh dari UIElement)
IsLoaded

Mendapatkan nilai yang menunjukkan apakah elemen telah ditambahkan ke pohon elemen dan siap untuk interaksi.

(Diperoleh dari FrameworkElement)
IsRightTapEnabled

Mendapatkan atau menetapkan nilai yang menentukan apakah peristiwa RightTapped dapat berasal dari elemen tersebut.

(Diperoleh dari UIElement)
IsTapEnabled

Mendapatkan atau menetapkan nilai yang menentukan apakah peristiwa yang Diketuk dapat berasal dari elemen tersebut.

(Diperoleh dari UIElement)
KeyboardAcceleratorPlacementMode

Mendapatkan atau mengatur nilai yang menunjukkan apakah tipsalat kontrol menampilkan kombinasi tombol untuk akselerator keyboard terkait.

(Diperoleh dari UIElement)
KeyboardAcceleratorPlacementTarget

Mendapatkan atau mengatur nilai yang menunjukkan tipsalat kontrol yang menampilkan kombinasi tombol akselerator.

(Diperoleh dari UIElement)
KeyboardAccelerators

Mendapatkan kumpulan kombinasi kunci yang memanggil tindakan menggunakan keyboard.

Akselerator biasanya ditetapkan ke tombol atau item menu.

Contoh menu yang memperlihatkan akselerator keyboard untuk berbagai item menu
Contoh menu yang memperlihatkan akselerator keyboard untuk berbagai item menu

(Diperoleh dari UIElement)
KeyTipHorizontalOffset

Mendapatkan atau menetapkan nilai yang menunjukkan seberapa jauh kiri atau kanan Tip Kunci ditempatkan sehubungan dengan UIElement.

(Diperoleh dari UIElement)
KeyTipPlacementMode

Mendapatkan atau menetapkan nilai yang menunjukkan di mana Tip Kunci kunci akses ditempatkan sehubungan dengan batas UIElement.

(Diperoleh dari UIElement)
KeyTipTarget

Mendapatkan atau menetapkan nilai yang menunjukkan elemen yang ditargetkan oleh Tip Kunci kunci akses.

(Diperoleh dari UIElement)
KeyTipVerticalOffset

Mendapatkan atau menetapkan nilai yang menunjukkan seberapa jauh tip kunci ditempatkan dalam kaitannya dengan elemen UI.

(Diperoleh dari UIElement)
Language

Mendapatkan atau mengatur informasi bahasa pelokalan/globalisasi yang berlaku untuk FrameworkElement, dan juga untuk semua elemen turunan dari FrameworkElement saat ini dalam representasi objek dan di UI.

(Diperoleh dari FrameworkElement)
Lights

Mendapatkan koleksi objek XamlLight yang melekat pada elemen ini.

(Diperoleh dari UIElement)
ManipulationMode

Mendapatkan atau menetapkan nilai ManipulationModes yang digunakan untuk perilaku UIElement dan interaksi dengan gerakan. Mengatur nilai ini memungkinkan penanganan peristiwa manipulasi dari elemen ini dalam kode aplikasi.

(Diperoleh dari UIElement)
Margin

Mendapatkan atau mengatur margin luar FrameworkElement.

(Diperoleh dari FrameworkElement)
MaxHeight

Mendapatkan atau mengatur batasan tinggi maksimum FrameworkElement.

(Diperoleh dari FrameworkElement)
MaxWidth

Mendapatkan atau mengatur batasan lebar maksimum FrameworkElement.

(Diperoleh dari FrameworkElement)
MinHeight

Mendapatkan atau mengatur batasan tinggi minimum FrameworkElement.

(Diperoleh dari FrameworkElement)
MinWidth

Mendapatkan atau mengatur batasan lebar minimum FrameworkElement.

(Diperoleh dari FrameworkElement)
Name

Mendapatkan atau mengatur nama pengidentifikasi objek. Ketika prosesor XAML membuat pohon objek dari markup XAML, kode run-time dapat merujuk ke objek yang dideklarasikan XAML dengan nama ini.

(Diperoleh dari FrameworkElement)
NineGrid

Mendapatkan atau menetapkan nilai untuk metafora sembilan kisi yang mengontrol bagaimana gambar dapat diubah ukurannya. Metafora sembilan kisi memungkinkan Anda meregangkan tepi dan sudut gambar secara berbeda dari tengahnya. Lihat Keterangan untuk informasi selengkapnya dan ilustrasi.

NineGridProperty

Mengidentifikasi properti dependensi NineGrid .

Opacity

Mendapatkan atau mengatur tingkat keburaman objek.

(Diperoleh dari UIElement)
OpacityTransition

Mendapatkan atau mengatur ScalarTransition yang menganimasikan perubahan pada properti Opacity.

(Diperoleh dari UIElement)
Parent

Mendapatkan objek induk dari FrameworkElement ini di pohon objek.

(Diperoleh dari FrameworkElement)
PlayToSource

Mendapatkan informasi yang ditransmisikan jika Gambar digunakan untuk skenario Play To.

PlayToSourceProperty

Mengidentifikasi properti dependensi PlayToSource .

PointerCaptures

Mendapatkan sekumpulan semua pointer yang diambil, yang dinyatakan sebagai nilai Pointer .

(Diperoleh dari UIElement)
Projection

Mendapatkan atau mengatur proyeksi perspektif (efek 3-D) untuk diterapkan saat merender elemen ini.

(Diperoleh dari UIElement)
RenderSize

Mendapatkan ukuran render akhir UIElement. Penggunaan tidak disarankan, lihat Keterangan.

(Diperoleh dari UIElement)
RenderTransform

Mendapatkan atau mengatur informasi transformasi yang memengaruhi posisi penyajian UIElement.

(Diperoleh dari UIElement)
RenderTransformOrigin

Mendapatkan atau mengatur titik asal dari setiap kemungkinan transformasi render yang dideklarasikan oleh RenderTransform, relatif terhadap batas UIElement.

(Diperoleh dari UIElement)
RequestedTheme

Mendapatkan atau mengatur tema UI yang digunakan oleh UIElement (dan elemen turunannya ) untuk penentuan sumber daya. Tema UI yang Anda tentukan dengan RequestedTheme dapat mengganti requestedTheme tingkat aplikasi.

(Diperoleh dari FrameworkElement)
Resources

Mendapatkan kamus sumber daya yang ditentukan secara lokal. Di XAML, Anda dapat membuat item sumber daya sebagai elemen objek anak dari frameworkElement.Resources elemen properti, melalui sintaks pengumpulan implisit XAML.

(Diperoleh dari FrameworkElement)
Rotation

Mendapatkan atau mengatur sudut rotasi searah jarum jam, dalam derajat. Memutar relatif terhadap RotationAxis dan CenterPoint. Mempengaruhi posisi penyajian elemen.

(Diperoleh dari UIElement)
RotationAxis

Mendapatkan atau mengatur sumbu untuk memutar elemen.

(Diperoleh dari UIElement)
RotationTransition

Mendapatkan atau mengatur ScalarTransition yang menganimasikan perubahan pada properti Rotasi.

(Diperoleh dari UIElement)
Scale

Mendapatkan atau mengatur skala elemen. Menskalakan relatif terhadap CenterPoint elemen. Mempengaruhi posisi penyajian elemen.

(Diperoleh dari UIElement)
ScaleTransition

Mendapatkan atau mengatur Vector3Transition yang menganimasikan perubahan pada properti Skala.

(Diperoleh dari UIElement)
Shadow

Mendapatkan atau mengatur efek bayangan yang dilemparkan oleh elemen .

(Diperoleh dari UIElement)
Source

Mendapatkan atau mengatur sumber untuk gambar.

SourceProperty

Mengidentifikasi properti dependensi Sumber .

Stretch

Mendapatkan atau menetapkan nilai yang menjelaskan bagaimana Gambar harus direntangkan untuk mengisi persegi panjang tujuan.

StretchProperty

Mengidentifikasi properti dependensi Stretch .

Style

Mendapatkan atau mengatur Gaya instans yang diterapkan untuk objek ini selama tata letak dan penyajian.

(Diperoleh dari FrameworkElement)
TabFocusNavigation

Mendapatkan atau menetapkan nilai yang memodifikasi cara kerja tabing dan TabIndex untuk kontrol ini.

(Diperoleh dari UIElement)
Tag

Mendapatkan atau menetapkan nilai objek arbitrer yang dapat digunakan untuk menyimpan informasi kustom tentang objek ini.

(Diperoleh dari FrameworkElement)
Transform3D

Mendapatkan atau mengatur efek transformasi 3-D untuk diterapkan saat merender elemen ini.

(Diperoleh dari UIElement)
TransformMatrix

Mendapatkan atau mengatur matriks transformasi untuk diterapkan ke elemen .

(Diperoleh dari UIElement)
Transitions

Mendapatkan atau mengatur kumpulan elemen gaya Transisi yang berlaku untuk UIElement.

(Diperoleh dari UIElement)
Translation

Mendapatkan atau mengatur posisi rendering x, y, dan z dari elemen.

(Diperoleh dari UIElement)
TranslationTransition

Mendapatkan atau mengatur Vector3Transition yang menganimasikan perubahan pada properti Terjemahan.

(Diperoleh dari UIElement)
Triggers

Mendapatkan koleksi pemicu untuk animasi yang ditentukan untuk FrameworkElement. Tidak umum digunakan. Lihat Keterangan.

(Diperoleh dari FrameworkElement)
UIContext

Mendapatkan pengidentifikasi konteks untuk elemen .

(Diperoleh dari UIElement)
UseLayoutRounding

Mendapatkan atau menetapkan nilai yang menentukan apakah penyajian untuk objek dan subtree visualnya harus menggunakan perilaku pembulatan yang menyelaraskan penyajian ke seluruh piksel.

(Diperoleh dari UIElement)
VerticalAlignment

Mendapatkan atau mengatur karakteristik perataan vertikal yang diterapkan ke FrameworkElement saat disusun dalam objek induk seperti kontrol panel atau item.

(Diperoleh dari FrameworkElement)
Visibility

Mendapatkan atau mengatur visibilitas UIElement. UIElement yang tidak terlihat tidak dirender dan tidak mengkomunikasikan ukuran yang diinginkan ke tata letak.

(Diperoleh dari UIElement)
Width

Mendapatkan atau mengatur lebar FrameworkElement.

(Diperoleh dari FrameworkElement)
XamlRoot

Mendapatkan atau mengatur tempat XamlRoot elemen ini dilihat.

(Diperoleh dari UIElement)
XYFocusDownNavigationStrategy

Mendapatkan atau menetapkan nilai yang menentukan strategi yang digunakan untuk menentukan elemen target navigasi bawah.

(Diperoleh dari UIElement)
XYFocusKeyboardNavigation

Mendapatkan atau mengatur nilai yang mengaktifkan atau menonaktifkan navigasi menggunakan panah arah keyboard.

(Diperoleh dari UIElement)
XYFocusLeftNavigationStrategy

Mendapatkan atau menetapkan nilai yang menentukan strategi yang digunakan untuk menentukan elemen target navigasi kiri.

(Diperoleh dari UIElement)
XYFocusRightNavigationStrategy

Mendapatkan atau menetapkan nilai yang menentukan strategi yang digunakan untuk menentukan elemen target navigasi yang tepat.

(Diperoleh dari UIElement)
XYFocusUpNavigationStrategy

Mendapatkan atau menetapkan nilai yang menentukan strategi yang digunakan untuk menentukan elemen target navigasi atas.

(Diperoleh dari UIElement)

Metode

AddHandler(RoutedEvent, Object, Boolean)

Menambahkan penanganan aktivitas yang dirutekan untuk peristiwa rute tertentu, menambahkan handler ke pengumpulan handler pada elemen saat ini. Tentukan handledEventsToo sebagai true agar handler yang disediakan dipanggil meskipun kejadian ditangani di tempat lain.

(Diperoleh dari UIElement)
Arrange(Rect)

Memposisikan objek anak dan menentukan ukuran untuk UIElement. Objek induk yang menerapkan tata letak kustom untuk elemen anak mereka harus memanggil metode ini dari implementasi penimpaan tata letaknya untuk membentuk pembaruan tata letak rekursif.

(Diperoleh dari UIElement)
ArrangeOverride(Size)

Menyediakan perilaku untuk pass tata letak "Atur". Kelas dapat mengambil alih metode ini untuk menentukan perilaku pass "Arrange" mereka sendiri.

(Diperoleh dari FrameworkElement)
CancelDirectManipulations()

Membatalkan pemrosesan manipulasi langsung yang sedang berlangsung (panning/zooming yang ditentukan sistem) pada induk ScrollViewer apa pun yang berisi UIElement saat ini.

(Diperoleh dari UIElement)
CapturePointer(Pointer)

Mengatur pengambilan pointer ke UIElement. Setelah ditangkap, hanya elemen yang telah menangkap yang akan menembakkan peristiwa terkait pointer.

(Diperoleh dari UIElement)
ClearValue(DependencyProperty)

Menghapus nilai lokal properti dependensi.

(Diperoleh dari DependencyObject)
FindName(String)

Mengambil objek yang memiliki nama pengidentifikasi yang ditentukan.

(Diperoleh dari FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

Memungkinkan subkelas UIElement untuk mengekspos elemen anak yang membantu menyelesaikan penargetan sentuhan.

(Diperoleh dari UIElement)
GetAlphaMask()

Mengembalikan masker yang mewakili saluran alfa gambar sebagai CompositionBrush.

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)
GetAsCastingSource()

Mengembalikan gambar sebagai CastingSource.

GetBindingExpression(DependencyProperty)

Mengembalikan BindingExpression yang mewakili pengikatan pada properti yang ditentukan.

(Diperoleh dari FrameworkElement)
GetChildrenInTabFocusOrder()

Memungkinkan subkelas UIElement untuk mengekspos elemen anak yang mengambil bagian dalam Fokus tab.

(Diperoleh dari UIElement)
GetValue(DependencyProperty)

Mengembalikan nilai efektif properti dependensi saat ini dari DependencyObject.

(Diperoleh dari DependencyObject)
GoToElementStateCore(String, Boolean)

Saat diimplementasikan di kelas turunan, memungkinkan konstruksi per status pohon visual untuk templat kontrol dalam kode, bukan dengan memuat XAML untuk semua status pada startup kontrol.

(Diperoleh dari FrameworkElement)
InvalidateArrange()

Membatalkan status pengaturan (tata letak) untuk UIElement. Setelah pembatalan, UIElement akan memperbarui tata letaknya, yang akan terjadi secara asinkron.

(Diperoleh dari UIElement)
InvalidateMeasure()

Membatalkan status pengukuran (tata letak) untuk UIElement.

(Diperoleh dari UIElement)
InvalidateViewport()

Membatalkan status viewport untuk UIElement yang digunakan untuk menghitung viewport yang efektif.

(Diperoleh dari FrameworkElement)
Measure(Size)

Updates DesiredSizeUIElement. Biasanya, objek yang menerapkan tata letak kustom untuk anak tata letak mereka memanggil metode ini dari implementasi MeasureOverride mereka sendiri untuk membentuk pembaruan tata letak rekursif.

(Diperoleh dari UIElement)
MeasureOverride(Size)

Menyediakan perilaku untuk lulus "Ukur" dari siklus tata letak. Kelas dapat mengambil alih metode ini untuk menentukan perilaku lulus "Ukur" mereka sendiri.

(Diperoleh dari FrameworkElement)
OnApplyTemplate()

Dipanggil setiap kali kode aplikasi atau proses internal (seperti kode tata letak pembangunan ulang) memanggil ApplyTemplate. Dalam istilah yang paling sederhana, ini berarti metode dipanggil tepat sebelum elemen UI ditampilkan di aplikasi Anda. Ambil alih metode ini untuk memengaruhi logika pasca-templat default kelas.

(Diperoleh dari FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

Dipanggil sebelum peristiwa BringIntoViewRequested terjadi.

(Diperoleh dari UIElement)
OnCreateAutomationPeer()

Saat diimplementasikan di kelas turunan, mengembalikan implementasi AutomationPeer khusus kelas untuk infrastruktur Microsoft UI Automation.

(Diperoleh dari UIElement)
OnDisconnectVisualChildren()

Ambil alih metode ini untuk mengimplementasikan bagaimana tata letak dan logika harus bersifat ketika item dihapus dari konten khusus kelas atau properti turunan.

(Diperoleh dari UIElement)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

Dipanggil saat pintasan keyboard (atau akselerator) diproses di aplikasi Anda. Ambil alih metode ini untuk menangani bagaimana aplikasi Anda merespons saat akselerator keyboard dipanggil.

(Diperoleh dari UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Dipanggil tepat sebelum pintasan keyboard (atau akselerator) diproses di aplikasi Anda. Dipanggil setiap kali kode aplikasi atau proses internal memanggil ProcessKeyboardAccelerators. Ambil alih metode ini untuk memengaruhi penanganan akselerator default.

(Diperoleh dari UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Menentukan properti yang dapat dianimasikan.

(Diperoleh dari UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

Saat ditimpa di kelas turunan, menentukan properti yang dapat dianimasikan.

(Diperoleh dari UIElement)
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)
ReleasePointerCapture(Pointer)

Melepaskan tangkapan penunjuk untuk menangkap satu penunjuk tertentu oleh UIElement ini.

(Diperoleh dari UIElement)
ReleasePointerCaptures()

Melepaskan semua tangkapan pointer yang dipegang oleh elemen ini.

(Diperoleh dari UIElement)
RemoveHandler(RoutedEvent, Object)

Menghapus penanganan aktivitas yang dirutekan yang ditentukan dari UIElement ini. Biasanya handler yang dimaksud ditambahkan oleh AddHandler.

(Diperoleh dari UIElement)
SetBinding(DependencyProperty, BindingBase)

Melampirkan pengikatan ke FrameworkElement, menggunakan objek pengikatan yang disediakan.

(Diperoleh dari FrameworkElement)
SetValue(DependencyProperty, Object)

Mengatur nilai lokal properti dependensi pada DependencyObject.

(Diperoleh dari DependencyObject)
StartAnimation(ICompositionAnimationBase)

Memulai animasi yang ditentukan pada elemen .

(Diperoleh dari UIElement)
StartBringIntoView()

Memulai permintaan ke kerangka kerja XAML untuk menampilkan elemen dalam wilayah yang dapat digulirkan di dalamnya.

(Diperoleh dari UIElement)
StartBringIntoView(BringIntoViewOptions)

Memulai permintaan ke kerangka kerja XAML untuk menampilkan elemen menggunakan opsi yang ditentukan.

(Diperoleh dari UIElement)
StartDragAsync(PointerPoint)

Memulai operasi seret dan letakkan.

(Diperoleh dari UIElement)
StopAnimation(ICompositionAnimationBase)

Menghentikan animasi yang ditentukan pada elemen .

(Diperoleh dari UIElement)
TransformToVisual(UIElement)

Mengembalikan objek transformasi yang dapat digunakan untuk mengubah koordinat dari UIElement ke objek yang ditentukan.

(Diperoleh dari UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Mencoba memanggil pintasan keyboard (atau akselerator) dengan mencari seluruh pohon visual UIElement untuk pintasan.

(Diperoleh dari UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Membatalkan pemberitahuan perubahan yang sebelumnya terdaftar dengan memanggil RegisterPropertyChangedCallback.

(Diperoleh dari DependencyObject)
UpdateLayout()

Memastikan bahwa semua posisi objek anak UIElement diperbarui dengan benar untuk tata letak.

(Diperoleh dari UIElement)

Acara

AccessKeyDisplayDismissed

Terjadi ketika kunci akses tidak boleh lagi ditampilkan.

(Diperoleh dari UIElement)
AccessKeyDisplayRequested

Terjadi ketika pengguna meminta agar kunci akses ditampilkan.

(Diperoleh dari UIElement)
AccessKeyInvoked

Terjadi ketika pengguna menyelesaikan urutan kunci akses.

(Diperoleh dari UIElement)
ActualThemeChanged

Terjadi ketika nilai properti ActualTheme telah berubah.

(Diperoleh dari FrameworkElement)
BringIntoViewRequested

Terjadi ketika StartBringIntoView dipanggil pada elemen ini atau salah satu keturunannya.

(Diperoleh dari UIElement)
CharacterReceived

Terjadi ketika karakter tunggal yang disusur diterima oleh antrean input.

(Diperoleh dari UIElement)
ContextCanceled

Terjadi ketika gerakan input konteks berlanjut ke dalam gerakan manipulasi, untuk memberi tahu elemen bahwa flyout konteks tidak boleh dibuka.

(Diperoleh dari UIElement)
ContextRequested

Terjadi ketika pengguna telah menyelesaikan gerakan input konteks, seperti klik kanan.

(Diperoleh dari UIElement)
DataContextChanged

Terjadi ketika nilai properti FrameworkElement.DataContext berubah.

(Diperoleh dari FrameworkElement)
DoubleTapped

Terjadi ketika interaksi DoubleTap yang tidak tertangani terjadi di atas area pengujian hit elemen ini.

(Diperoleh dari UIElement)
DragEnter

Terjadi ketika sistem input melaporkan peristiwa seret yang mendasar dengan elemen ini sebagai target.

(Diperoleh dari UIElement)
DragLeave

Terjadi ketika sistem input melaporkan peristiwa seret yang mendasar dengan elemen ini sebagai asalnya.

(Diperoleh dari UIElement)
DragOver

Terjadi ketika sistem input melaporkan peristiwa seret yang mendasar dengan elemen ini sebagai target penurunan potensial.

(Diperoleh dari UIElement)
DragStarting

Terjadi ketika operasi seret dimulai.

(Diperoleh dari UIElement)
Drop

Terjadi ketika sistem input melaporkan peristiwa penurunan yang mendasar dengan elemen ini sebagai target penghilangan.

(Diperoleh dari UIElement)
DropCompleted

Terjadi ketika operasi seret dan letakkan dengan elemen ini saat sumber berakhir.

(Diperoleh dari UIElement)
EffectiveViewportChanged

Terjadi ketika viewport efektifFrameworkElement berubah.

(Diperoleh dari FrameworkElement)
GettingFocus

Terjadi sebelum UIElement menerima fokus. Peristiwa ini dinaikkan secara sinkron untuk memastikan fokus tidak dipindahkan saat peristiwa bergelombang.

(Diperoleh dari UIElement)
GotFocus

Terjadi ketika UIElement menerima fokus. Kejadian ini dinaikkan secara asinkron, sehingga fokus dapat bergerak lagi sebelum gelembung selesai.

(Diperoleh dari UIElement)
Holding

Terjadi ketika interaksi Hold yang tidak tertangani terjadi di atas area pengujian hit dari elemen ini.

(Diperoleh dari UIElement)
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 alami sumber gambar.

KeyDown

Terjadi ketika tombol keyboard ditekan saat UIElement memiliki fokus.

(Diperoleh dari UIElement)
KeyUp

Terjadi ketika tombol keyboard dilepaskan saat UIElement memiliki fokus.

(Diperoleh dari UIElement)
LayoutUpdated

Terjadi ketika tata letak pohon visual berubah, karena properti yang relevan dengan tata letak mengubah nilai atau beberapa tindakan lain yang menyegarkan tata letak.

(Diperoleh dari FrameworkElement)
Loaded

Terjadi ketika FrameworkElement telah dibangun dan ditambahkan ke pohon objek, dan siap untuk interaksi.

(Diperoleh dari FrameworkElement)
Loading

Terjadi ketika FrameworkElement mulai dimuat.

(Diperoleh dari FrameworkElement)
LosingFocus

Terjadi sebelum UIElement kehilangan fokus. Peristiwa ini dinaikkan secara sinkron untuk memastikan fokus tidak dipindahkan saat peristiwa bergelombang.

(Diperoleh dari UIElement)
LostFocus

Terjadi ketika UIElement kehilangan fokus. Kejadian ini dinaikkan secara asinkron, sehingga fokus dapat bergerak lagi sebelum gelembung selesai.

(Diperoleh dari UIElement)
ManipulationCompleted

Terjadi ketika manipulasi pada UIElement selesai.

(Diperoleh dari UIElement)
ManipulationDelta

Terjadi ketika perangkat input berubah posisi selama manipulasi.

(Diperoleh dari UIElement)
ManipulationInertiaStarting

Terjadi ketika perangkat input kehilangan kontak dengan objek UIElement selama manipulasi dan inertia dimulai.

(Diperoleh dari UIElement)
ManipulationStarted

Terjadi ketika perangkat input memulai manipulasi pada UIElement.

(Diperoleh dari UIElement)
ManipulationStarting

Terjadi ketika prosesor manipulasi pertama kali dibuat.

(Diperoleh dari UIElement)
NoFocusCandidateFound

Terjadi ketika pengguna mencoba memindahkan fokus (melalui tab atau panah arah), tetapi fokus tidak bergerak karena tidak ada kandidat fokus yang ditemukan ke arah gerakan.

(Diperoleh dari UIElement)
PointerCanceled

Terjadi ketika pointer yang membuat kontak secara tidak normal kehilangan kontak.

(Diperoleh dari UIElement)
PointerCaptureLost

Terjadi ketika penunjuk menangkap yang sebelumnya dipegang oleh elemen ini berpindah ke elemen lain atau di tempat lain.

(Diperoleh dari UIElement)
PointerEntered

Terjadi ketika pointer memasuki area pengujian hit elemen ini.

(Diperoleh dari UIElement)
PointerExited

Terjadi ketika pointer meninggalkan area pengujian hit dari elemen ini.

(Diperoleh dari UIElement)
PointerMoved

Terjadi ketika penunjuk bergerak sementara penunjuk tetap berada dalam area uji hit elemen ini.

(Diperoleh dari UIElement)
PointerPressed

Terjadi ketika perangkat penunjuk memulai tindakan Tekan dalam elemen ini.

(Diperoleh dari UIElement)
PointerReleased

Terjadi ketika perangkat penunjuk yang sebelumnya memulai tindakan Tekan dirilis, sementara dalam elemen ini. Perhatikan bahwa akhir tindakan Tekan tidak dijamin akan mengaktifkan peristiwa PointerReleased; peristiwa lain mungkin diaktifkan sebagai gantinya. Untuk informasi selengkapnya, lihat Keterangan.

(Diperoleh dari UIElement)
PointerWheelChanged

Terjadi ketika nilai delta roda penunjuk berubah.

(Diperoleh dari UIElement)
PreviewKeyDown

Terjadi ketika tombol keyboard ditekan saat UIElement memiliki fokus.

(Diperoleh dari UIElement)
PreviewKeyUp

Terjadi ketika tombol keyboard dilepaskan saat UIElement memiliki fokus.

(Diperoleh dari UIElement)
ProcessKeyboardAccelerators

Terjadi ketika pintasan keyboard (atau akselerator) ditekan.

(Diperoleh dari UIElement)
RightTapped

Terjadi saat stimulus input ketuk kanan terjadi saat penunjuk berada di atas elemen .

(Diperoleh dari UIElement)
SizeChanged

Terjadi ketika properti ActualHeight atau ActualWidth mengubah nilai pada FrameworkElement.

(Diperoleh dari FrameworkElement)
Tapped

Terjadi ketika interaksi Ketuk yang tidak tertangani terjadi di atas area pengujian hit elemen ini.

(Diperoleh dari UIElement)
Unloaded

Terjadi ketika objek ini tidak lagi tersambung ke pohon objek utama.

(Diperoleh dari FrameworkElement)

Berlaku untuk

Lihat juga