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 pertama-tama MinWidth harus dihormati, maka MaxWidth, dan akhirnya jika masing-masing berada dalam batas, Width.

Nilai yang dikembalikan dari 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 alasan tertentu. Selain itu, sistem tata letak itu sendiri bekerja secara asinkron relatif terhadap set Width sistem properti dan mungkin belum memproses perubahan properti ukuran tertentu tersebut.

Selain nilai yang dapat Double diterima, properti ini juga bisa .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 merender, dan tidak ada pengecualian yang 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 tidak deterministik ini.

Penggunaan Atribut XAML

<object Width="double"/>  

-atau-

<object Width ="qualifiedDouble"/>  

-atau-

<object Width ="Auto"/>  

Nilai XAML

double
Double

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, , incm, pt.

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 pengotomatisan. Lihat Keterangan.

Informasi Properti Dependensi

Bidang pengidentifikasi	WidthProperty
Properti metadata diatur ke true	AffectsMeasure