FrameworkElement.Height Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows
Bütünleştirilmiş Kod:
PresentationFramework.dll

Öğesinin önerilen yüksekliğini alır veya ayarlar.

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

Özellik Değeri

Double

Cihazdan bağımsız birimlerde (birim başına 1/96 inç) elemanın yüksekliği. NaN varsayılan değerdir. Bu değer 0,0'a eşit veya ondan büyük olmalıdır.

Öznitelikler
TypeConverterAttribute LocalizabilityAttribute

Açıklamalar

Height , yükseklik bilgilerini belirten üzerine FrameworkElement yazılabilir üç özellikten biridir. Diğer ikisi ve MaxHeightşeklindedirMinHeight. Bu değerler arasında bir çakışma varsa, gerçek yükseklik belirleme için uygulamanın sırası önce MinHeight yerine getirilmesi gerektiğidir; sonra MaxHeight, ve son olarak, sınırlar içindeyse . Height

Bu öğe başka bir öğenin içindeki bir alt öğeyse, bu özelliği bir değere ayarlamak yalnızca önerilen bir değerdir. Düzen sistemi ve üst öğenin belirli düzen mantığı, düzen işlemi sırasında değeri bağlamayan giriş olarak kullanır. Pratik anlamda, bir FrameworkElement neredeyse her zaman başka bir şeyin alt öğesidir; öğesini ayarladığınızda HeightWindowbile. (için Windowbu değer, temel alınan uygulama modeli uygulamayı barındıran Hwnd'i oluşturan temel işleme varsayımlarını oluşturduğunda kullanılır.)

Kabul edilebilir Double değerlere ek olarak, bu özellik de olabilir Double.NaN. Kodda otomatik boyutlandırma davranışını bu şekilde belirtirsiniz. XAML'de otomatik boyutlandırma davranışını etkinleştirmek için değeri "Otomatik" (büyük/küçük harfe duyarsız) dizesine ayarlarsınız. Otomatik boyutlandırma davranışı, öğenin kullanılabilir yüksekliği dolduracağını gösterir. Ancak belirli denetimlerin, özellikle yeniden etkinleştirilmediği sürece otomatik boyutlandırma davranışını devre dışı bırakacak varsayılan tema stilleri aracılığıyla sık sık varsayılan değerler sağladığını unutmayın.

Bu özelliğin dönüş değeri her zaman ona ayarlanan değerle aynıdır. Buna karşılık, değerinin ActualHeight değeri değişebilir. Bu durum, düzen herhangi bir nedenle önerilen boyutu reddettiği için veya kısa bir süre için statik olarak gerçekleşebilir. Düzen sisteminin kendisi, özellik sisteminin kümesine Height göre zaman uyumsuz olarak çalışır ve bu boyutlandırma özelliği değişikliğini henüz işlememiş olabilir.

Değer üzerindeki Double değer kısıtlamaları bir ValidateValueCallback mekanizma tarafından zorlanır. Geçersiz bir değer ayarlamaya çalışırsanız, bir çalışma zamanı özel durumu oluşturulur.

Doğrulama denetimine ek olarak, düzen sistemi tarafından zorlanan için Height belirleyici olmayan bir üst değer vardır (bu çok büyük bir sayıdır, büyüktür Single.MaxValue ama küçüktür Double.MaxValue). Bu sınırı aşarsanız, öğesi işlenmez ve hiçbir özel durum oluşturulmaz. Herhangi bir görsel görüntülemenin maksimum boyutundan önemli ölçüde daha büyük bir değere ayarlamayın Height , aksi durumda bu belirleyici olmayan üst sınırı aşabilirsiniz.

XAML Öznitelik Kullanımı

<object Height="double"/>

-veya-

<object Height="qualifiedDouble"/>

-veya-

<object Height="Auto"/>

XAML Değerleri

double
Double

0,0'a eşit veya 0,0'dan büyük bir Double değerin dize gösterimi. Üst sınır bilgileri için bkz. Açıklamalar. Bu değer cihazdan bağımsız birim (1/96 inç) ölçümü olarak yorumlanır. Dizelerin açıkça ondalık ayırıcı içermesi gerekmez. Örneğin değeri 1 kabul edilebilir.

qualifiedDouble
Yukarıda açıklandığı gibi bir çift değer ve ardından aşağıdaki birim bildirim dizelerinden biri: px, in, cm, pt.

px (varsayılan) cihazdan bağımsız birimlerdir (birim başına 1/96 inç)

in inçtir; 1 inç==96px

cm santimetredir; 1cm==(96/2,54) piksel

pt puandır; 1pt==(96/72) piksel

Otomatik
Otomatikleştirme davranışını etkinleştirir. Bkz. Açıklamalar.

Bağımlılık Özelliği Bilgileri
Tanımlayıcı alanı HeightProperty
Meta veri özellikleri olarak ayarlandı true AffectsMeasure

Şunlara uygulanır

Ayrıca bkz.