Image.Stretch Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

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

public:
 property Stretch Stretch { Stretch get(); void set(Stretch value); };

Stretch Stretch();

void Stretch(Stretch value);

public Stretch Stretch { get; set; }

var stretch = image.stretch;
image.stretch = stretch;

Public Property Stretch As Stretch

<Image Stretch="stretchValue"/>

Nilai Properti

Stretch

Nilai enumerasi Stretch yang menentukan bagaimana gambar sumber dirender, jika Tinggi dan/atau LebarGambar tidak ditentukan secara eksplisit. Nilai defaultnya adalah Seragam.

Keterangan

Nilai properti Stretch hanya relevan jika instans Gambar belum menggunakan nilai yang ditetapkan secara eksplisit untuk properti Tinggi dan/atau Lebar , dan jika instans Gambar berada di dalam kontainer yang dapat meregangkan gambar untuk mengisi beberapa ruang yang tersedia dalam tata letak. Jika Anda mengatur nilai properti Stretch ke None, gambar selalu mempertahankan ukuran alaminya, bahkan jika ada kontainer tata letak yang mungkin meregangkannya sebaliknya. Untuk informasi selengkapnya tentang ukuran gambar, lihat Keterangan di Gambar.

Sumber dan penskalakan gambar

Anda harus membuat sumber gambar pada beberapa ukuran yang direkomendasikan, untuk memastikan bahwa aplikasi Anda terlihat hebat saat Windows menskalakannya karena penskalaan dan resolusi perangkat. Ini sering kali merupakan cara yang lebih baik untuk menangani pengubahan ukuran gambar daripada menerapkan nilai Stretch nondefault. Saat menentukan Sumber untuk Gambar, 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 Memuat gambar dan aset yang disesuaikan untuk skala.

Untuk informasi selengkapnya tentang cara merancang penskalaan, lihat Pengantar desain aplikasi Windows.

Catatan

Nilai Stretch None tidak berfungsi untuk sumber daya gambar yang dimaksudkan untuk mendukung penskalaan. Penskalaan akan terdeteksi dan sumber daya berskala yang sesuai dimuat sebelum keputusan tata letak yang tersirat oleh nilai Tidak Ada diterapkan.