FrameworkElement.Height 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 tinggi frameworkElement yang disarankan.
public:
property double Height { double get(); void set(double value); };double Height();
void Height(double value);public double Height { get; set; }var double = frameworkElement.height;
frameworkElement.height = double;Public Property Height As Double<frameworkElement Height="double"/>
-or-
<frameworkElement Height="Auto"/>
Nilai Properti
double
Tinggi, dalam piksel, objek . 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 kontennya 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
Tinggi adalah salah satu dari tiga properti bisa-tulis pada FrameworkElement yang menentukan informasi tinggi. Dua lainnya adalah MinHeight dan MaxHeight. Jika ada konflik antara nilai-nilai ini, urutan aplikasi untuk penentuan tinggi aktual adalah bahwa MinHeight pertama harus dihormati, maka MaxHeight, dan akhirnya, jika berada dalam batas, Tinggi.
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 di kumpulan 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 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 ActualHeight 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 Tinggi sistem properti, dan sistem tata letak mungkin belum memproses perubahan properti ukuran tersebut.
Nilai negatif untuk Tinggi tidak diizinkan.
Selain itu, jangan atur Tinggi ke nilai yang secara signifikan lebih besar dari ukuran maksimum tampilan visual yang mungkin.
"Otomatis" dan NaN
Nilai default Tinggi dan Lebar adalah "Otomatis", yang 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.
Sistem tata letak menginterpretasikan nilai "Otomatis" secara umum berarti bahwa objek harus berukuran hingga ukuran yang tersedia dalam tata letak, bukan ke nilai piksel tertentu.