FrameworkElement.Height Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur tinggi elemen yang disarankan.

public:
 property double Height { double get(); void set(double value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Height { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Height : double with get, set

Public Property Height As Double

Nilai Properti

Double

Tinggi elemen, dalam unit perangkat-independen (1/96 inci per unit). Nilai defaultnya adalah NaN. Nilai ini harus sama dengan atau lebih besar dari 0,0.

Atribut

TypeConverterAttribute LocalizabilityAttribute

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.

Jika elemen ini adalah elemen anak dalam beberapa elemen lain, maka mengatur properti ini ke nilai benar-benar hanya nilai yang disarankan. Sistem tata letak serta logika tata letak tertentu dari elemen induk akan menggunakan nilai sebagai input non-pengikatan selama proses tata letak. Dalam istilah praktis, FrameworkElement hampir selalu elemen anak dari sesuatu yang lain; bahkan ketika Anda mengatur Height pada Window. (Untuk Window, nilai tersebut digunakan ketika model aplikasi yang mendasar menetapkan asumsi penyajian dasar yang membuat Hwnd yang menghosting aplikasi.)

Selain nilai yang dapat Double diterima, properti ini juga bisa .Double.NaN Ini adalah cara Anda menentukan perilaku ukuran otomatis dalam kode. Di XAML Anda mengatur nilai ke string "Otomatis" (tidak peka huruf besar/kecil) untuk mengaktifkan perilaku ukuran otomatis. Perilaku ukuran otomatis menyiratkan bahwa elemen akan mengisi tinggi yang tersedia untuknya. Namun perhatikan bahwa kontrol tertentu sering menyediakan nilai default melalui gaya tema defaultnya yang akan menonaktifkan perilaku ukuran otomatis kecuali diaktifkan kembali secara khusus.

Nilai yang dikembalikan dari properti ini selalu sama dengan nilai apa pun yang diatur ke properti tersebut. Sebaliknya, nilai ActualHeight dapat bervariasi. Ini dapat terjadi baik secara statis karena tata letak menolak ukuran yang disarankan karena alasan tertentu, atau sesaat. Sistem tata letak itu sendiri bekerja secara asinkron relatif terhadap set Height sistem properti dan mungkin belum memproses perubahan properti ukuran tertentu tersebut.

Pembatasan nilai pada nilai diberlakukan Double oleh ValidateValueCallback mekanisme. Jika Anda mencoba mengatur nilai yang tidak valid, pengecualian run-time akan dilemparkan.

Selain pemeriksaan validasi, ada batas nilai atas nondeterministik untuk Height yang diberlakukan oleh sistem tata letak (ini adalah angka yang sangat besar, lebih besar dari Single.MaxValue tetapi lebih kecil dari Double.MaxValue). Jika Anda melebihi batas ini, elemen tidak akan merender, dan tidak ada pengecualian yang dilemparkan. Jangan atur Height ke nilai yang secara signifikan lebih besar dari ukuran maksimum tampilan visual yang mungkin, atau Anda mungkin melebihi batas atas nondeterministik ini.

Penggunaan Atribut XAML

<object Height="double"/>  

-atau-

<object Height="qualifiedDouble"/>  

-atau-

<object Height="Auto"/>  

Nilai XAML

double
Double

Representasi string dari nilai yang Double sama dengan atau lebih besar dari 0,0. Lihat Keterangan untuk informasi terikat atas. Nilai ini ditafsirkan sebagai pengukuran unit independen perangkat (1/96 inci). String tidak perlu secara eksplisit menyertakan titik desimal. Misalnya, nilai 1 dapat diterima.

qualifiedDouble
Nilai ganda seperti yang dijelaskan di atas, diikuti oleh salah satu string deklarasi unit berikut: px, , in, cm. pt

px (default) adalah unit independen perangkat (1/96 inci per unit)

in adalah inci; 1in==96px

cm adalah sentimeter; 1cm==(96/2,54) px

pt adalah poin; 1pt==(96/72) px

Auto
Mengaktifkan perilaku autosizing. Lihat Keterangan.

Informasi Properti Dependensi

Bidang pengidentifikasi	HeightProperty
Properti metadata diatur ke true	AffectsMeasure

Lihat juga

• ActualHeight