Image.NineGrid Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

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.

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

Thickness NineGrid();

void NineGrid(Thickness value);

public Thickness NineGrid { get; set; }

var thickness = image.nineGrid;
image.nineGrid = thickness;

Public Property NineGrid As Thickness

<Image NineGrid="left,top,right,bottom" />

Nilai Properti

Thickness

Nilai Ketebalan yang menetapkan pengukuran Kiri, Atas, Kanan, Bawah untuk metafora pengubahan ukuran sembilan kisi.

Keterangan

Saat Anda menggunakan penyajian sembilan kisi, Anda dapat menentukan bagaimana area gambar yang berbeda direntangkan. Fitur ini berguna untuk mempertahankan detail tentang sudut gambar saat gambar diskalakan atau direntangkan.

Penyajian sembilan kisi membagi gambar menjadi kisi sembilan bagian:

Penyajian sembilan kisi memungkinkan Anda mempertahankan dimensi asli sudut (kotak 1, 3, 7, dan 9). Bagian atas dan bawah (kotak 2 dan 8) hanya direntangkan secara horizontal, dan sisi (kotak 4 dan 6) direntangkan secara vertikal saja. Bagian tengah (kotak 5) direntangkan di kedua dimensi. Untuk menggunakan penyajian sembilan kisi, Anda membuat

Menerapkan penyajian sembilan kisi sangat berguna ketika gambar itu sendiri mencakup beberapa jenis hiasan batas atau tepi yang disematkan dalam sumber gambar. Misalnya, bayangkan Anda menggunakan sumber gambar untuk Tombol yang memiliki kerangka sebagai bagian dari gambar dengan transparansi. Anda mungkin ingin area tengah yang berisi ikon untuk direntangkan. Tetapi jika Anda meregangkan sudut-sudut, Anda mungkin mendapatkan alias artefak dari sudut bulat. Atau sisi perbatasan mungkin terlalu tebal dan tidak akan terlihat sebagus saat diskalakan. Untuk mencegahnya, Anda dapat menggunakan NineGrid dengan nilai seragam yang selalu menjaga ukuran piksel batas berukuran sama seperti di sumber gambar.

Baik dalam kode atau di XAML, nilai untuk Ketebalan yang Anda gunakan untuk mengatur properti NineGrid adalah nilai piksel independen perangkat.

Berikut adalah contoh XAML untuk elemen Gambar menggunakan nilai NineGrid:

<Image Source="Images/9grid.bmp" NineGrid="30,20,30,20" />

Nilai NineGrid hanya relevan untuk penyajian gambar jika gambar tidak memiliki nilai khusus yang diatur untuk Lebar dan/atau Tinggi, dan di mana gambar sedang direntangkan (gambar dirender ke dalam ruang kontainer yang lebih besar dan nilai untuk Stretch bukan** None**).

Lihat juga

• Thickness
• Sampel gambar XAML