FrameworkElement.Width Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur lebar elemen.

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

[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Width { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Width : double with get, set

Public Property Width As Double

Nilai Properti

Double

Lebar elemen, dalam unit independen perangkat (1/96 inci per unit). Nilai defaultnya adalah NaN. Nilai ini harus sama dengan atau lebih besar dari 0,0. Lihat Keterangan untuk informasi terikat atas.

Atribut

TypeConverterAttribute LocalizabilityAttribute

Keterangan

Ini adalah salah satu dari tiga properti pada FrameworkElement yang menentukan informasi lebar. Dua lainnya adalah MinWidth dan MaxWidth. Jika ada konflik antara nilai-nilai ini, urutan aplikasi untuk penentuan lebar aktual harus terlebih dahulu MinWidth dihormati, maka MaxWidth, dan akhirnya jika masing-masing berada dalam batas, Width.

Nilai pengembalian properti ini selalu sama dengan nilai apa pun yang diatur ke properti tersebut. Sebaliknya, nilai ActualWidth dapat bervariasi. Tata letak mungkin telah menolak ukuran yang disarankan karena beberapa alasan. Selain itu, sistem tata letak itu sendiri bekerja secara asinkron relatif terhadap kumpulan Width sistem properti dan mungkin belum memproses perubahan properti ukuran tertentu tersebut.

Selain nilai yang dapat Double diterima, properti ini juga dapat berupa Double.NaN. Ini adalah cara Anda menentukan perilaku ukuran otomatis. Di XAML Anda mengatur nilai ke string "Otomatis" (tidak peka huruf besar/kecil) untuk mengaktifkan perilaku ukuran otomatis. Perilaku ukuran otomatis menyiratkan bahwa elemen akan mengisi lebar yang tersedia untuknya. Namun perhatikan bahwa kontrol tertentu sering menyediakan nilai default dalam gaya defaultnya yang akan menonaktifkan perilaku ukuran otomatis kecuali secara khusus diaktifkan kembali.

Selain pemeriksaan validasi, ada nilai atas nondeterministik yang terikat untuk Width yang diberlakukan oleh sistem tata letak (ini adalah angka yang sangat besar, lebih besar dari Single.MaxValue tetapi lebih kecil dari Double.MaxValue). Jika Anda melebihi batas ini, elemen tidak akan dirender, dan tidak terkecuali dilemparkan. Jangan atur Width ke nilai yang secara signifikan lebih besar dari ukuran maksimum tampilan visual yang mungkin, atau Anda mungkin melebihi batas atas yang tidakdeterministik ini.

Penggunaan Atribut XAML

<object Width="double"/>

-atau-

<object Width ="qualifiedDouble"/>

-atau-

<object Width ="Auto"/>

Nilai XAML

DoubleDouble

Representasi string dari nilai yang Double sama dengan atau lebih besar dari 0,0. Lihat Keterangan untuk informasi terikat atas. Nilai ini ditafsirkan sebagai pengukuran unit independen perangkat (1/96 inci). String tidak perlu secara eksplisit menyertakan titik desimal. Misalnya nilai 1 dapat diterima.

qualifiedDouble Nilai ganda seperti yang dijelaskan di atas, diikuti oleh salah satu string deklarasi unit berikut: px, , in, cmpt.

px (default) adalah unit independen perangkat (1/96 inci per unit)

in adalah inci; 1in==96px

cm adalah sentimeter; 1cm==(96/2,54) px

pt adalah poin; 1pt==(96/72) px

Auto Mengaktifkan perilaku autosizing. Lihat Komentar.

Informasi Properti Dependensi

Barang	Nilai
Bidang pengidentifikasi	WidthProperty
Properti metadata diatur ke true	AffectsMeasure