FrameworkElement.Height Propriété

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"/>
 

Valeur de propriété

Hauteur, en pixels, de l’objet. La valeur par défaut est NaN. À l’exception de la valeur NaN spéciale, cette valeur doit être égale ou supérieure à 0.

Exemples

Cet exemple montre un jeu de propriétés simple d’un élément d’interface utilisateur créé au moment de l’exécution et nécessite l’initialisation de son contenu et des propriétés d’affichage de base telles que HeightWidth et Background. (L’arrière-plan est en fait une propriété Control , non définie par FrameworkElement.)

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

Remarques

Height est l’une des trois propriétés accessibles en écriture sur FrameworkElement qui spécifient des informations de 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.

Plusieurs types dérivés de FrameworkElement sont également dérivés de Shape. Toutes les Shape classes n’utilisent Height pas ou width pour spécifier leur apparence, et utilisent plutôt des propriétés spécifiques qui peuvent définir un ensemble de points. Dans ce cas, une ou Width est Height calculée, mais n’est généralement pas définie directement.

Les classes personnalisées peuvent avoir des considérations similaires dans lesquelles la classe peut avoir des propriétés plus significatives pour spécifier des dimensions que Heightla largeur. Height ou Width sont toujours disponibles en tant que membres et sont définissables.

L’objet où les Height propriétés ou Width sont définies est presque toujours un objet enfant dans la collection enfant d’un autre parent, et le paramètre Height ou Width une valeur n’est qu’une valeur suggérée pour le processus de disposition. Le système de disposition, ainsi que la logique de disposition particulière de la classe parente, utilise la valeur comme entrée non liée pendant le processus de disposition et peut avoir à découper, redimensionner l’objet, redimensionner le conteneur ou une combinaison de ces comportements qui s’étendent sur plusieurs objets participants à la disposition. La marge et le remplissage influencent également la taille disponible. Pour plus d’informations, consultez Alignement, marge et remplissage.

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 de la propriété ActualHeight peut varier. La variance peut se produire de manière statique, car la disposition a rejeté la taille suggérée ou momentanément. Le système de disposition lui-même fonctionne de manière asynchrone par rapport à l’ensemble de hauteur du système de propriétés, et le système de disposition n’a peut-être pas encore traité cette modification de propriété de dimensionnement.

Les valeurs négatives pour Height ne sont pas autorisées.

En outre, ne définissez Height pas sur une valeur qui est considérablement supérieure à la taille maximale de tout affichage visuel possible.

« Auto » et NaN

La valeur par défaut et Heightwidth est « Auto », représentée par NaN. Dans le balisage XAML, vous pouvez utiliser la chaîne « Auto » pour définir la valeur sur NaN.

Voir aussi

• Width
• ActualHeight
• MinHeight
• MaxHeight
• Définir des dispositions avec XAML
• Alignement, marge et remplissage