FrameworkElement.Height Proprietà

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

Valore della proprietà

Altezza dell'elemento, in unità indipendenti dal dispositivo (1/96° pollice per unità). Il valore predefinito è NaN. Questo valore deve essere uguale o maggiore di 0,0.

Attributi

TypeConverterAttribute LocalizabilityAttribute

Commenti

Height è una delle tre proprietà scrivibili in che specificano le informazioni sull'altezza FrameworkElement . Gli altri due sono MinHeight e MaxHeight. Se si verifica un conflitto tra questi valori, l'ordine di applicazione per la determinazione effettiva dell'altezza è che prima MinHeight deve essere rispettato, quindi MaxHeighte infine, se si trova all'interno di limiti, Height.

Se questo elemento è un elemento figlio all'interno di un altro elemento, impostare questa proprietà su un valore è in realtà solo un valore suggerito. Il sistema di layout e la particolare logica di layout dell'elemento padre useranno il valore come input non di associazione durante il processo di layout. In termini pratici, un FrameworkElement è quasi sempre l'elemento figlio di qualcos'altro; anche quando si imposta su HeightWindow. Per Window, tale valore viene usato quando il modello di applicazione sottostante stabilisce i presupposti di rendering di base che creano l'oggetto Hwnd che ospita l'applicazione.

Oltre ai valori accettabili Double , questa proprietà può anche essere Double.NaN. Questo è il modo in cui si specifica il comportamento di ridimensionamento automatico nel codice. In XAML il valore viene impostato sulla stringa "Auto" (senza distinzione tra maiuscole e minuscole) per abilitare il comportamento di ridimensionamento automatico. Il comportamento di ridimensionamento automatico implica che l'elemento riempirà l'altezza disponibile. Si noti tuttavia che i controlli specifici forniscono spesso valori predefiniti tramite i relativi stili di tema predefiniti che disabiliteranno il comportamento di ridimensionamento automatico, a meno che non sia riabilitato in modo specifico.

Il valore restituito di questa proprietà è sempre uguale a qualsiasi valore impostato su di esso. Al contrario, il valore di ActualHeight può variare. Ciò può verificarsi in modo statico perché il layout ha rifiutato le dimensioni suggerite per qualche motivo o momentaneamente. Il sistema di layout stesso funziona in modo asincrono rispetto al set di proprietà del sistema di Height proprietà e potrebbe non aver ancora elaborato tale modifica specifica della proprietà di ridimensionamento.

Le restrizioni relative al Double valore vengono applicate da un ValidateValueCallback meccanismo. Se si tenta di impostare un valore non valido, viene generata un'eccezione di runtime.

Oltre al controllo di convalida, esiste un limite di valore superiore non deterministico per Height che viene applicato dal sistema di layout (si tratta di un numero molto elevato, maggiore di ma minore Single.MaxValue di Double.MaxValue). Se si supera questo limite, l'elemento non verrà eseguito il rendering e non verrà generata alcuna eccezione. Non impostare Height su un valore significativamente maggiore della dimensione massima di qualsiasi visualizzazione visiva possibile oppure è possibile superare questo limite superiore non deterministico.

Utilizzo degli attributi XAML

<object Height="double"/>

oppure

<object Height="qualifiedDouble"/>

oppure

<object Height="Auto"/>

Valori XAML

DoppiaDouble

Rappresentazione di stringa di un Double valore uguale o maggiore di 0,0. Per informazioni sul limite superiore, vedere La sezione Osservazioni. Questo valore viene interpretato come misura di unità indipendente dal dispositivo (1/96 pollici). Le stringhe non devono includere in modo esplicito i separatori decimali. Ad esempio, un valore di 1 è accettabile.

qualifiedDouble Valore double come descritto in precedenza, seguito da una delle stringhe di dichiarazione di unità seguenti: px, incm, , pt.

px (impostazione predefinita) è unità indipendenti dal dispositivo (1/96 pollici per unità)

in è pollici; 1in==96 px

cm è centimetri; 1cm==(96/2.54) px

pt è punti; 1pt==(96/72) px

Automatico Abilita il comportamento di ridimensionamento automatico. Vedere la sezione Osservazioni.

Informazioni sulle proprietà di dipendenza

Vedi anche

• ActualHeight