FrameworkElement.Height Propriété

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

Valeur de propriété

Hauteur de l’élément, en unités indépendantes de l’appareil (1/96e pouce par unité). La valeur par défaut est NaN. Cette valeur doit être égale ou supérieure à 0,0.

Attributs

TypeConverterAttribute LocalizabilityAttribute

Remarques

Height est l’une des trois propriétés accessibles en écriture pour spécifier les informations de FrameworkElement hauteur. Les deux autres sont MinHeight et MaxHeight. S’il existe un conflit entre ces valeurs, l’ordre de l’application pour la détermination de la hauteur réelle est qu’il doit d’abord MinHeight être respecté, puis MaxHeight, enfin, s’il se trouve dans des limites, Height.

Si cet élément est un élément enfant dans un autre élément, la définition de cette propriété sur une valeur n’est vraiment qu’une valeur suggérée. Le système de disposition, ainsi que la logique de disposition particulière de l’élément parent, utilise la valeur comme entrée non liée pendant le processus de disposition. En pratique, un FrameworkElement est presque toujours l’élément enfant de quelque chose d’autre ; même lorsque vous définissez le Height .Window (Pour Window, cette valeur est utilisée lorsque le modèle d’application sous-jacent établit les hypothèses de rendu de base qui créent le Hwnd qui héberge l’application.)

En plus des valeurs acceptables Double , cette propriété peut également être Double.NaN. Il s’agit de la façon dont vous spécifiez le comportement de dimensionnement automatique dans le code. En XAML, vous définissez la valeur sur la chaîne « Auto » (sans respect de la casse) pour activer le comportement de dimensionnement automatique. Le comportement de dimensionnement automatique implique que l’élément remplira la hauteur disponible. Notez toutefois que des contrôles spécifiques fournissent fréquemment des valeurs par défaut par le biais de leurs styles de thème par défaut qui désactivent le comportement de dimensionnement automatique, sauf s’il est spécifiquement réactivé.

La valeur de retour de cette propriété est toujours identique à n’importe quelle valeur qui lui a été définie. En revanche, la valeur du fichier ActualHeight peut varier. Cela peut se produire statiquement, car la disposition a rejeté la taille suggérée pour une raison quelconque, ou momentanément. Le système de disposition lui-même fonctionne de façon asynchrone par rapport à l’ensemble du système de Height propriétés et n’a peut-être pas encore traité ce changement de propriété de dimensionnement particulier.

Les restrictions de valeur sur la Double valeur sont appliquées par un ValidateValueCallback mécanisme. Si vous tentez de définir une valeur non valide, une exception d’exécution est levée.

En plus de la vérification de validation, il existe une valeur supérieure non déterministe liée à Height celle-ci appliquée par le système de disposition (il s’agit d’un très grand nombre, supérieur mais Single.MaxValue inférieur à Double.MaxValue). Si vous dépassez cette limite, l’élément ne s’affiche pas et aucune exception n’est levée. Ne définissez Height pas sur une valeur qui est considérablement supérieure à la taille maximale de tout affichage visuel possible, ou vous pouvez dépasser cette limite supérieure non déterministe.

Utilisation des attributs XAML

<object Height="double"/>

- ou -

<object Height="qualifiedDouble"/>

- ou -

<object Height="Auto"/>

Valeurs XAML

DoubleDouble

Représentation sous forme de chaîne d’une Double valeur égale ou supérieure à 0,0. Consultez les remarques pour obtenir des informations relatives aux limites supérieures. Cette valeur est interprétée comme une mesure indépendante de l’appareil (1/96e pouce). Les chaînes n’ont pas besoin d’inclure explicitement les décimales. Par exemple, une valeur est 1 acceptable.

qualifiedDouble Valeur double comme décrit ci-dessus, suivie de l’une des chaînes de déclaration d’unité suivantes : px, , in, cmpt.

px (valeur par défaut) est des unités indépendantes de l’appareil (1/96e pouce par unité)

in est pouces ; 1in==96px

cm est en centimètres ; 1cm==(96/2.54) px

pt est des points ; 1pt==(96/72) px

Auto Active le comportement de redimensionnement automatique. Voir les remarques.

Informations sur les propriétés de dépendance

Voir aussi

• ActualHeight