Thickness Struktur

Referensi

Definisi

Ruang nama:: Windows.UI.Xaml

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

Menjelaskan ketebalan bingkai di sekitar persegi panjang. Empat nilai Ganda menjelaskan sisi Kiri, Atas, Kanan, dan Bawah dari persegi panjang.

public value class Thickness

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
struct Thickness

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public struct Thickness

Public Structure Thickness

<Thickness ...>uniform</Thickness>
- or -
<Thickness ...>left&right,top&bottom</Thickness>
- or -
<Thickness ...>left,top,right,bottom</Thickness>
- or -
<object property="uniform"/>
- or -
<object property="left&right,top&bottom"/>
- or -
<object property="left,top,right,bottom" ... />

Warisan: ValueType
Thickness

Atribut: ContractVersionAttribute

Persyaratan Windows

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

Keterangan

Nilai ketebalan umumnya digunakan untuk mengatur properti yang memengaruhi tata letak objek tempat properti diatur. Properti yang menggunakan nilai Ketebalan meliputi:

FrameworkElement.Margin
Control.Padding
Border.BorderThickness dan Control.BorderThickness
Properti Margin dan Padding lainnya pada kelas yang bukan Kontrol, misalnya RichTextBlock.Padding
Image.NineGrid
Shape.StrokeThickness
ProgressBarTemplateSettings.EllipseOffset

Di XAML, Anda dapat menentukan nilai Ketebalan dalam beberapa cara. Jika Anda menentukan empat nilai Ganda , nilai ini mewakili sisi Kiri, Atas, Kanan, dan Bawah , masing-masing, dari persegi panjang pembatas. Jika Anda menentukan dua nilai, nilai ini mewakili nilai Kiri, Atas , dan juga menerapkan nilai yang sama ke Kanan dan Bawah sehingga Ketebalan yang dihasilkan bersifat isometrik secara horizontal dan isometrik secara vertikal. Anda juga dapat menyediakan satu nilai, yang menerapkan nilai seragam ke keempat sisi persegi panjang pembatas.

Nilai yang ditetapkan dari kode tidak memiliki perilaku apa pun yang dapat mengekstrapolasi nilai. Jika Anda menetapkan nilai untuk properti atau bidang Kiri , Anda tidak secara otomatis menetapkan nilai yang sama untuk Kanan. Semua properti Ketebalan harus diatur secara diskrit dalam kode. Anda dapat menggunakan konstruktor Ketebalan(Ganda) atau Ketebalan (Ganda,Ganda,Ganda,Ganda) daripada menetapkan nilai ke properti.

Meskipun jenis nilai data Ketebalan adalah Ganda, Anda biasanya menentukan nilai bilangan bulat.

Catatan tentang sintaks XAML

String yang menentukan tiga nilai tidak menyebabkan kesalahan pengurai, tetapi hanya dua nilai pertama yang ditafsirkan, dan nilai ketiga apa pun diabaikan.

Meskipun Anda dapat menentukan Ketebalan sebagai elemen objek, Anda tidak dapat menentukan nilai individual seperti Teratas sebagai atribut elemen objek tersebut. Parser XAML tidak mendukung pengaturan nilai atribut XAML untuk struktur ini. Sebagai gantinya, Anda harus menentukan nilai sebagai teks inisialisasi dalam Ketebalan. Menggunakan sintaks elemen objek untuk Ketebalan berguna jika Anda ingin mendeklarasikan sumber daya kunci yang dapat digunakan oleh beberapa instans Kontrol untuk Padding mereka. Untuk informasi selengkapnya tentang teks inisialisasi XAML, lihat panduan sintaks XAML.

Anda dapat menggunakan spasi daripada koma sebagai pemisah di antara nilai.

Proyeksi dan anggota Ketebalan

Jika Anda menggunakan bahasa Microsoft .NET (C# atau Microsoft Visual Basic), atau ekstensi komponen Visual C++ (C++/CX), ketebalan memiliki anggota non-data yang tersedia, dan anggota datanya diekspos sebagai properti baca-tulis, bukan bidang. Lihat Ketebalan di Browser .NET API.

Jika Anda memprogram dengan C++/WinRT atau Windows Runtime C++ Template Library (WRL), maka hanya bidang anggota data yang ada sebagai anggota Ketebalan, dan Anda tidak dapat menggunakan metode utilitas atau properti proyeksi .NET. Kode C++ dapat mengakses metode utilitas serupa yang ada di kelas ThicknessHelper .

Tabel ini memperlihatkan metode yang setara yang tersedia di .NET dan C++.

.NET (Ketebalan)	C++ (ThicknessHelper)
Ketebalan(Ganda)	FromUniformLength(Double)
Ketebalan(Ganda, Ganda, Ganda, Ganda)	FromLengths(Double, Double, Double, Double)

Bidang

Bottom	Ukuran tepi bawah Ketebalan.
Left	Ukuran sisi kiri Ketebalan.
Right	Ukuran sisi kanan Ketebalan.
Top	Ukuran tepi atas Ketebalan.

Berlaku untuk