FrameworkElement.Height Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml

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

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 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 atau HeightLebar. 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.

Lihat juga

• Width
• ActualHeight
• MinHeight
• MaxHeight
• Menentukan tata letak dengan XAML
• Perataan, margin, dan padding