FrameworkElement.Height Propriété

Définition

Obtient ou définit la hauteur suggérée de l’élément.

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 supérieure ou égale à 0.0.

Attributs

Remarques

Height est l’une des trois propriétés accessibles en écriture sur qui spécifient des informations de FrameworkElement hauteur. Les deux autres sont MinHeight et MaxHeight. En cas de conflit entre ces valeurs, l’ordre d’application pour la détermination de la hauteur réelle est que doit d’abord MinHeight être respecté, puis MaxHeight, et enfin, s’il est dans des limites, Height.

Si cet élément est un élément enfant au sein d’un autre élément, la définition d’une valeur à cette propriété n’est en fait qu’une valeur suggérée. Le système de disposition, ainsi que la logique de disposition particulière de l’élément parent, utilisent la valeur comme entrée sans liaison pendant le processus de disposition. En pratique, un FrameworkElement est presque toujours l’élément enfant d’un autre élément , même lorsque vous définissez sur HeightWindow. (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. C’est ainsi que vous spécifiez le comportement de dimensionnement automatique dans le code. En XAML, vous définissez la valeur sur la chaîne « Auto » (qui ne respecte pas 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 via 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 la même que toute valeur qui lui a été définie. En revanche, la valeur de peut ActualHeight varier. Cela peut se produire soit de manière statique, car la disposition a rejeté la taille suggérée pour une raison quelconque, soit momentanément. Le système de disposition lui-même fonctionne de manière asynchrone par rapport à l’ensemble du système de propriétés de Height et n’a peut-être pas encore traité cette modification de propriété de dimensionnement particulière.

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 validation case activée, il existe une valeur supérieure non déterministe liée à Height qui est appliquée par le système de disposition (il s’agit d’un nombre très important, supérieur Single.MaxValue à mais 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 d’un affichage visuel possible, ou vous pouvez dépasser cette limite supérieure non déterministe.

Utilisation d'attributs XAML

<object Height="double"/>  

- ou -

<object Height="qualifiedDouble"/>  

- ou -

<object Height="Auto"/>  

Valeurs XAML

double
Double

Représentation sous forme de chaîne d’une Double valeur égale ou supérieure à 0,0. Consultez la section Notes pour plus d’informations sur la limite supérieure. Cette valeur est interprétée comme une mesure d’unité indépendante de l’appareil (1/96e pouce). Les chaînes n’ont pas besoin d’inclure explicitement des décimales. Par instance une valeur de 1 est acceptable.

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

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

in est en pouces ; 1in==96px

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

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

Auto
Active le comportement de redimensionnement automatique. Consultez la section Notes.

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

Champ Identificateur HeightProperty
Propriétés de métadonnées définies sur true AffectsMeasure

S’applique à

Voir aussi