FrameworkElement.Height Proprietà

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

Ottiene o imposta l'altezza suggerita di un FrameworkElement.

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

void Height(double value);
public double Height { get; set; }
var double = frameworkElement.height;
frameworkElement.height = double;
Public Property Height As Double
<frameworkElement Height="double"/>
-or-
<frameworkElement Height="Auto"/>

Valore della proprietà

Double

double

Altezza, in pixel, dell'oggetto . Il valore predefinito è NaN. Ad eccezione del valore NaN speciale, questo valore deve essere uguale o maggiore di 0.

Esempio

Questo esempio mostra un semplice set di proprietà di un elemento dell'interfaccia utente creato in fase di esecuzione e richiede l'inizializzazione del contenuto e le proprietà di visualizzazione di base, ad Height esempio e Width e Background. Background è in realtà una proprietà Control, non definita da FrameworkElement.

Button button2 = new Button();
button2.Height = 50;
button2.Width = 100;
button2.Background = new SolidColorBrush(Colors.Blue);
button2.Content = "Click Me";

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 prima MinHeight deve essere rispettato, quindi MaxHeighte infine, se si trova all'interno di limiti, Height.

Diversi tipi derivati di FrameworkElement sono derivati anche da Shape. Non tutte le Shape classi usano Height o Width per specificarne l'aspetto e usano invece proprietà specifiche che potrebbero definire un set di punti. In questo caso un Height oggetto o Width viene calcolato, ma in genere non viene impostato direttamente.

Le classi personalizzate possono avere considerazioni simili in cui la classe potrebbe avere proprietà più significative per specificare le dimensioni di Height o Width. Height o Width sono entrambi disponibili come membri e sono impostabili.

L'oggetto in cui vengono impostate le Height proprietà o Width è quasi sempre un oggetto figlio nella raccolta figlio di un altro padre e l'impostazione Height o Width su un valore è solo un valore suggerito per il processo di layout. Il sistema di layout e la particolare logica di layout della classe padre useranno il valore come input non di associazione durante il processo di layout e potrebbero dover ritagliare, ridimensionare l'oggetto, ridimensionare il contenitore o alcune combinazioni di questi comportamenti che si estendono su più oggetti partecipanti nel layout. Il margine e la spaziatura interna influisce anche sulle dimensioni disponibili. Per altre info, vedi Allineamento, margine e riempimento.

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

I valori negativi per Height non sono consentiti.

Inoltre, non impostare Height su un valore notevolmente superiore alla dimensione massima di qualsiasi visualizzazione visiva possibile.

"Auto" e NaN

Il valore predefinito di Height e Width è "Auto", rappresentato da NaN. Nel markup XAML puoi usare la stringa "Auto" per impostare il valore su NaN.

Note

In C# è possibile ottenere NaN da Double.NaN.

In C++, è possibile ottenere NaN usando la NAN macro o std::numeric_limits<double>::quiet_NaN().

Non usare l'operatore per eseguire il == test per NaN.

In C# usare Double.IsNaN() per eseguire il test per NaN.

In C++, usare isnan() per eseguire il test per NaN.

Si applica a

Vedi anche