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 sekumpulan properti sederhana dari elemen UI yang dibuat pada durasi dan memerlukan inisialisasi konten dan properti tampilan dasar seperti Tinggi, Width, 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";
Keterangan
Width 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 pertama-tama MinWidth harus dihormati, maka MaxWidth, dan akhirnya, jika berada dalam batas, Width.
Beberapa jenis turunan FrameworkElement juga berasal dari Shape. Tidak semua Shape kelas menggunakan Tinggi atau Width untuk menentukan penampilannya, dan sebaliknya menggunakan properti tertentu yang mungkin menentukan sekumpulan titik. Dalam hal ini atau HeightWidth 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 Width.
Height atau Width keduanya masih tersedia sebagai anggota dan dapat diatur.
Objek tempat Tinggi atau Width properti diatur hampir selalu merupakan objek anak dalam kumpulan anak induk lain, dan pengaturan Height atau Width 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 non-pengikatan 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 Widthsistem properti , dan sistem tata letak mungkin belum memproses perubahan properti ukuran tersebut.
Nilai negatif untuk Width tidak diizinkan.
Selain itu, jangan atur Width ke nilai yang secara signifikan lebih besar dari ukuran maksimum tampilan visual yang mungkin.
"Otomatis" dan NaN
Nilai default Tinggi dan Width adalah "Otomatis", diwakili oleh NaN. Di markup XAML, Anda dapat menggunakan string "Otomatis" untuk mengatur nilai ke NaN.
Catatan
Di 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.