FrameworkElement.Height Proprietà

Definizione

Ottiene o imposta l'altezza consigliata dell'elemento.Gets or sets the suggested height of the element.

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; }
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 di pollice per unità)device-independent units (1/96th inch per unit).The height of the element, in unità indipendenti dal dispositivo (1/96 di pollice per unità)device-independent units (1/96th inch per unit). Il valore predefinito è NaN.The default value is NaN. Questo valore deve essere maggiore o uguale a 0,0.This value must be equal to or greater than 0.0.

Attributi

Commenti

Height è una delle tre proprietà scrivibili FrameworkElement che specificano le informazioni sull'altezza.Height is one of three writable properties on FrameworkElement that specify height information. Gli altri due sono MinHeight e MaxHeight.The other two are MinHeight and MaxHeight. Se si verifica un conflitto tra questi valori, l'ordine di applicazione per la determinazione dell'altezza effettiva è che devono essere rispettati prima MinHeight, quindi MaxHeighte infine, se si trova all'interno dei limiti, Height.If there is a conflict between these values, the order of application for actual height determination is that first MinHeight must be honored, then MaxHeight, and finally, if it is within bounds, 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.If this element is a child element within some other element, then setting this property to a value is really only a suggested value. Il sistema di layout e la logica di layout specifica dell'elemento padre utilizzeranno il valore come input non di binding durante il processo di layout.The layout system as well as the particular layout logic of the parent element will use the value as a nonbinding input during the layout process. In pratica, un FrameworkElement è quasi sempre l'elemento figlio di qualcos'altro; anche quando si imposta il Height Window.In practical terms, a FrameworkElement is almost always the child element of something else; even when you set the Height on Window. Per Window, questo valore viene utilizzato quando il modello di applicazione sottostante stabilisce i presupposti di rendering di base che creano l'oggetto HWND che ospita l'applicazione.(For Window, that value is used when the underlying application model establishes the basic rendering assumptions that create the Hwnd that hosts the application.)

Oltre ai valori Double accettabili, questa proprietà può anche essere Double.NaN.In addition to acceptable Double values, this property can also be Double.NaN. Questo è il modo in cui si specifica il comportamento di ridimensionamento automatico nel codice.This is how you specify auto sizing behavior in code. In XAMLXAML è possibile impostare il valore sulla stringa "auto" (senza distinzione tra maiuscole e minuscole) per abilitare il comportamento di dimensionamento automatico.In XAMLXAML you set the value to the string "Auto" (case insensitive) to enable the auto sizing behavior. Il comportamento di ridimensionamento automatico implica che l'elemento riempirà l'altezza disponibile.Auto sizing behavior implies that the element will fill the height available to it. Si noti tuttavia che i controlli specifici forniscono spesso valori predefiniti tramite gli stili di tema predefiniti che disabilitano il comportamento di ridimensionamento automatico a meno che non sia riabilitata in modo specifico.Note however that specific controls frequently supply default values through their default theme styles that will disable the auto sizing behavior unless it is specifically re-enabled.

Il valore restituito di questa proprietà è sempre uguale a qualsiasi valore impostato.The return value of this property is always the same as any value that was set to it. Al contrario, il valore della ActualHeight può variare.In contrast, the value of the ActualHeight may vary. Questa operazione può essere eseguita in modo statico perché il layout ha rifiutato le dimensioni consigliate per qualche motivo o momentaneamente.This can happen either statically because the layout rejected the suggested size for some reason, or momentarily. Il sistema di layout funziona in modo asincrono rispetto al set di Height del sistema di proprietà e potrebbe non avere ancora elaborato la modifica della proprietà di ridimensionamento.The layout system itself works asynchronously relative to the property system's set of Height and may not have processed that particular sizing property change yet.

Le restrizioni relative al valore Double vengono applicate da un meccanismo di ValidateValueCallback.The value restrictions on the Double value are enforced by a ValidateValueCallback mechanism. Se si tenta di impostare un valore non valido, viene generata un'eccezione in fase di esecuzione.If you attempt to set an invalid value, a run-time exception is thrown.

Oltre al controllo di convalida, viene associato un valore superiore non deterministico per Height applicato dal sistema di layout (si tratta di un numero molto elevato, maggiore di Single.MaxValue ma minore di Double.MaxValue).In addition to the validation check, there is a nondeterministic upper value bound for Height that is enforced by the layout system (this is a very large number, larger than Single.MaxValue but smaller than Double.MaxValue). Se si supera questo limite, l'elemento non verrà sottoposta a rendering e non verrà generata alcuna eccezione.If you exceed this bound, the element will not render, and no exception is thrown. Non impostare Height su un valore significativamente superiore alla dimensione massima di qualsiasi visualizzazione visiva possibile oppure è possibile che venga superato questo limite superiore non deterministico.Do not set Height to a value that is significantly larger than the maximum size of any possible visual display, or you may exceed this nondeterministic upper bound.

Uso della sintassi XAML per gli attributiXAML Attribute Usage

<object Height="double"/>  

-oppure--or-

<object Height="qualifiedDouble"/>  

-oppure--or-

<object Height="Auto"/>  

Valori XAMLXAML Values

doubledouble
Double

Rappresentazione di stringa di un valore Double uguale o maggiore di 0,0.String representation of a Double value equal to or greater than 0.0. Per informazioni sul limite superiore, vedere la sezione Osservazioni.See Remarks for upper bound information. Questo valore viene interpretato come una misura unità indipendente dal dispositivo (1/96 di pollice)device-independent unit (1/96th inch).This value is interpreted as a unità indipendente dal dispositivo (1/96 di pollice)device-independent unit (1/96th inch) measurement. Le stringhe non devono includere in modo esplicito i punti decimali.Strings need not explicitly include decimal points. Ad esempio, il valore 1 è accettabile.For instance a value of 1 is acceptable.

qualifiedDoublequalifiedDouble
Un valore Double come descritto in precedenza, seguito da una delle seguenti stringhe di dichiarazione di unità: px, in, cm``pt.A double value as described above, followed by one of the following unit declaration strings: px, in, cm, pt.

px (impostazione predefinita) è unità indipendenti dal dispositivo (1/96 di pollice per unità)device-independent units (1/96th inch per unit)px (default) is unità indipendenti dal dispositivo (1/96 di pollice per unità)device-independent units (1/96th inch per unit)

in è in pollici; 1in = = 96pxin is inches; 1in==96px

cm è centimetro; 1 cm = = (96/2,54) pxcm is centimeters; 1cm==(96/2.54) px

pt è Points; 1Pt = = (96/72) pxpt is points; 1pt==(96/72) px

AutoAuto
Abilita il comportamento di ridimensionamento automatico.Enables autosizing behavior. Vedere la sezione Osservazioni.See Remarks.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field HeightProperty
Proprietà dei metadati impostate su trueMetadata properties set to true AffectsMeasure

Si applica a

Vedi anche