FrameworkElement.Width Properti
Definisi
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.
Mendapatkan atau mengatur lebar FrameworkElement.
public:
property double Width { double get(); void set(double value); };
double Width();
void Width(double value);
public double Width { get; set; }
var double = frameworkElement.width;
frameworkElement.width = double;
Public Property Width As Double
<frameworkElement Width="double"/>
-or-
<frameworkElement Width="Auto"/>
Nilai Properti
double
Lebar objek, dalam piksel. Defaultnya adalah NaN. Kecuali untuk nilai NaN khusus, nilai ini harus sama dengan atau lebih besar dari 0.
Contoh
Contoh ini menunjukkan kumpulan properti sederhana dari elemen UI yang dibuat pada durasi dan memerlukan inisialisasi konten dan properti tampilan dasar seperti Tinggi dan Lebar dan Latar Belakang. (Latar belakang sebenarnya adalah properti Kontrol , tidak ditentukan oleh FrameworkElement.)
Button button2 = new Button();
button2.Height = 50;
button2.Width = 100;
button2.Background = new SolidColorBrush(Colors.Blue);
button2.Content = "Click Me";
Dim button2 As Button = New Button
button2.Height = 50
button2.Width = 100
button2.Background = New SolidColorBrush(Colors.Blue)
button2.Content = "Click Me"
Keterangan
Lebar adalah salah satu dari tiga properti bisa-tulis 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 adalah bahwa MinWidth pertama harus dihormati, maka MaxWidth, dan akhirnya, jika berada dalam batas, Lebar.
Beberapa jenis turunan FrameworkElement juga berasal dari Shape. Tidak semua kelas Bentuk menggunakan Tinggi atau Lebar untuk menentukan tampilannya, dan sebaliknya menggunakan properti tertentu yang mungkin menentukan sekumpulan titik. Dalam hal ini , Tinggi atau Lebar dihitung, tetapi biasanya tidak diatur secara langsung.
Kelas kustom mungkin memiliki pertimbangan serupa di mana kelas mungkin memiliki properti yang lebih bermakna untuk menentukan dimensi daripada Tinggi atau Lebar. Tinggi atau Lebar masih tersedia sebagai anggota dan dapat diatur.
Objek tempat properti Tinggi atau Lebar diatur hampir selalu merupakan objek anak dalam koleksi anak induk lain, dan mengatur Tinggi atau Lebar ke nilai hanyalah nilai yang disarankan untuk proses tata letak. Sistem tata letak serta logika tata letak tertentu dari kelas induk akan menggunakan nilai sebagai input yang tidak mengikat selama proses tata letak, dan mungkin harus mengklip, mengubah ukuran objek, mengubah ukuran kontainer, atau beberapa kombinasi perilaku ini yang mencakup beberapa objek yang berpartisipasi dalam tata letak. Margin dan padding juga memengaruhi ukuran yang tersedia. Untuk informasi selengkapnya, lihat Perataan, margin, dan padding.
Nilai yang dikembalikan dari properti ini selalu sama dengan nilai apa pun yang diatur ke properti tersebut. Sebaliknya, nilai properti ActualWidth dapat bervariasi. Varians dapat terjadi baik secara statis, karena tata letak menolak ukuran yang disarankan, atau sesaat. Sistem tata letak itu sendiri bekerja secara asinkron relatif terhadap set Lebar sistem properti, dan sistem tata letak mungkin belum memproses perubahan properti ukuran tersebut.
Nilai negatif untuk Lebar tidak diizinkan.
Selain itu, jangan atur Lebar ke nilai yang secara signifikan lebih besar dari ukuran maksimum tampilan visual yang mungkin.
"Otomatis" dan NaN
Nilai default Tinggi dan Lebar adalah "Otomatis", diwakili oleh NaN. Di markup XAML, Anda dapat menggunakan string "Otomatis" untuk mengatur nilai ke NaN.
Catatan
Dalam C#, Anda dapat memperoleh NaN dari Double.NaN.
Di C++, Anda bisa mendapatkan NaN dengan menggunakan NAN
makro atau std::numeric_limits<double>::quiet_NaN()
.
Jangan gunakan ==
operator untuk menguji NaN.
Di C#, gunakan Double.IsNaN() untuk menguji NaN.
Di C++, gunakan isnan() untuk menguji NaN.
Sistem tata letak menginterpretasikan nilai "Otomatis" secara umum berarti bahwa objek harus berukuran sesuai ukuran yang tersedia dalam tata letak, bukan ke nilai piksel tertentu.