FrameworkElement.Height Vlastnost

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Získá nebo nastaví navrhovanou výšku prvku.

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

Hodnota vlastnosti

Double

Výška prvku v jednotkách nezávislých na zařízení (1/96 palce na jednotku). Výchozí hodnota je NaN. Tato hodnota musí být rovna nebo větší než 0,0.

Atributy

TypeConverterAttribute LocalizabilityAttribute

Poznámky

Height je jednou ze tří zapisovatelných vlastností, které určují výšku FrameworkElement . Další dvě jsou MinHeight a MaxHeight. Pokud dojde ke konfliktu mezi těmito hodnotami, pořadí použití pro určení skutečné výšky je takové, že je třeba nejprve MinHeight respektovat , pak MaxHeight, a nakonec, pokud je v mezích, Height.

Pokud je tento element podřízeným prvkem v rámci některého jiného prvku, je nastavení této vlastnosti na hodnotu ve skutečnosti pouze navrhovaná hodnota. Systém rozložení a konkrétní logika rozložení nadřazeného elementu budou používat hodnotu jako vstup, který není v průběhu procesu rozložení. Prakticky řečeno FrameworkElement je téměř vždy podřízeným prvkem něčeho jiného, a to i v případě, že nastavíte HeightWindow. (Pro Windowse tato hodnota použije, když podkladový aplikační model stanoví základní předpoklady vykreslování, které vytvářejí Hwnd, který hostuje aplikaci.)

Kromě přijatelných Double hodnot může být Double.NaNtato vlastnost také . Tímto způsobem určíte chování automatické změny velikosti v kódu. V XAML nastavíte hodnotu na řetězec "Auto" (bez rozlišování malých a velkých písmen), aby se povolilo chování automatického nastavení velikosti. Chování automatického nastavení velikosti znamená, že element vyplní výšku, která je pro něj k dispozici. Všimněte si však, že konkrétní ovládací prvky často poskytují výchozí hodnoty prostřednictvím výchozích stylů motivů, které zakážou chování automatického nastavení velikosti, pokud není výslovně znovu povoleno.

Vrácená hodnota této vlastnosti je vždy stejná jako jakákoli hodnota, která byla na ni nastavena. Naproti tomu se hodnota ActualHeight může lišit. K tomu může dojít buď staticky, protože rozložení z nějakého důvodu odmítlo navrhovanou velikost, nebo na chvíli. Samotný systém rozložení pracuje asynchronně vzhledem k sadě Height vlastností systému a je možné, že ještě nezpracoval konkrétní změnu vlastnosti velikosti.

Omezení hodnoty pro Double hodnotu jsou vynucena mechanismem ValidateValueCallback . Pokud se pokusíte nastavit neplatnou hodnotu, vyvolá se výjimka za běhu.

Kromě ověřovací kontroly existuje nedeterministická horní mez hodnoty, Height která je vynucena systémem rozložení (jedná se o velmi velké číslo, větší než Single.MaxValue , ale menší než Double.MaxValue). Pokud překročíte tuto hranici, prvek se nevykreslí a nevyvolá se žádná výjimka. Nenastavujte Height hodnotu, která je výrazně větší než maximální velikost libovolného možného vizuálního zobrazení, jinak můžete tuto nedeterministický horní mez překročit.

Použití atributu XAML

<object Height="double"/>  

-nebo-

<object Height="qualifiedDouble"/>  

-nebo-

<object Height="Auto"/>  

Hodnoty XAML

double
Double

Řetězcové vyjádření Double hodnoty rovnající se nebo větší než 0,0 Informace o horní hranici najdete v části Poznámky. Tato hodnota je interpretována jako měření nezávislé na jednotce (1/96 palce). Řetězce nemusí explicitně obsahovat desetinné čárky. Například hodnota 1 je přijatelná.

qualifiedDouble
Dvojitá hodnota, jak je popsáno výše, následovaná jedním z následujících řetězců deklarací jednotek: px, in, , cm. pt

px (výchozí) je jednotka nezávislá na zařízení (1/96 palce na jednotku).

in je palce; 1in==96px

cm je centimetry; 1cm==(96/2,54) px

pt jsou body; 1pt==(96/72) px

Auto
Umožňuje chování automatické velikosti. Viz Poznámky.

Informace o vlastnosti závislosti

Pole Identifikátor	HeightProperty
Vlastnosti metadat nastavené na true	AffectsMeasure

Viz také

• ActualHeight