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 sekumpulan properti sederhana dari elemen UI yang dibuat pada durasi dan memerlukan inisialisasi konten dan properti tampilan dasar seperti Height
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";
Keterangan
Height
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 pertama-tama MinHeight
harus dihormati, maka MaxHeight
, dan akhirnya, jika berada dalam batas, Height
.
Beberapa jenis turunan FrameworkElement juga berasal dari Shape. Tidak semua Shape
kelas menggunakan Height
atau Lebar untuk menentukan tampilannya, dan sebaliknya menggunakan properti tertentu yang mungkin menentukan sekumpulan titik. Dalam hal ini atau Height
Width
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 atau Height
Lebar.
Height
atau Width
keduanya masih tersedia sebagai anggota dan dapat diatur.
Objek tempat Height
properti atau Lebar 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 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 Height
tidak diizinkan.
Selain itu, jangan atur Height
ke nilai yang secara signifikan lebih besar dari ukuran maksimum tampilan visual yang mungkin.
"Otomatis" dan NaN
Nilai Height
default 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.