FrameworkElement.Height Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Ottiene o imposta l'altezza consigliata dell'elemento.

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à

Double

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

Attributi

TypeConverterAttribute LocalizabilityAttribute

Commenti

Height è una delle tre proprietà scrivibili in FrameworkElement che specificano le informazioni sull'altezza. 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 MinHeight prima 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, l'impostazione di questa proprietà su un valore è in realtà solo un valore suggerito. Il sistema di layout e la logica di layout specifica dell'elemento padre useranno il valore come input non di associazione durante il processo di layout. In termini pratici, un FrameworkElement oggetto è 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 disabilitano il comportamento di ridimensionamento automatico, a meno che non sia abilitato di nuovo 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 la modifica della proprietà di ridimensionamento specifica.

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 massimo non deterministico per Height che viene applicato dal sistema di layout (si tratta di un numero molto grande, maggiore di Single.MaxValue ma minore 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.

Uso della sintassi XAML per gli attributi

<object Height="double"/>  

-oppure-

<object Height="qualifiedDouble"/>  

-oppure-

<object Height="Auto"/>  

Valori XAML

double
Double

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, in, cm, pt.

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

in è pollici; 1in==96px

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

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

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

Informazioni proprietà di dipendenza

Campo Identificatore	HeightProperty
Proprietà dei metadati impostate su true	AffectsMeasure

Vedi anche

• ActualHeight