FrameworkElement.VerticalAlignment Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit les caractéristiques d’alignement vertical qui sont appliquées à un FrameworkElement lorsqu’il est composé dans un objet parent tel qu’un panneau ou un contrôle d’éléments.
public:
property VerticalAlignment VerticalAlignment { VerticalAlignment get(); void set(VerticalAlignment value); };
VerticalAlignment VerticalAlignment();
void VerticalAlignment(VerticalAlignment value);
public VerticalAlignment VerticalAlignment { get; set; }
var verticalAlignment = frameworkElement.verticalAlignment;
frameworkElement.verticalAlignment = verticalAlignment;
Public Property VerticalAlignment As VerticalAlignment
<frameworkElement VerticalAlignment="verticalAlignmentMemberName"/>
Valeur de propriété
Paramètre d’alignement vertical, en tant que valeur de l’énumération. Par défaut, il s’agit de Stretch
.
Exemples
Dans cet exemple, la valeur Center
est affectée à HorizontalAlignment et VerticalAlignment
à positionner les éléments TextBlock au centre des cellules Grid .
<Grid x:Name="LayoutRoot" Background="Coral" Width="300" Height="100">
<Grid.ColumnDefinitions>
<ColumnDefinition />
<ColumnDefinition />
</Grid.ColumnDefinitions>
<Grid.RowDefinitions>
<RowDefinition />
<RowDefinition />
</Grid.RowDefinitions>
<TextBlock Grid.Column="0" Grid.Row="0" Text="First Name"
HorizontalAlignment="Center" VerticalAlignment="Center" />
<TextBlock Grid.Column="0" Grid.Row="1" Text="Last Name"
HorizontalAlignment="Center" VerticalAlignment="Center" />
<TextBox Grid.Column="1" Grid.Row="0" />
<TextBox Grid.Column="1" Grid.Row="1" />
</Grid>
Remarques
Les propriétés d’alignement sont destinées à indiquer la disposition souhaitée à un conteneur de disposition adaptative. Ils sont généralement définis sur les enfants FrameworkElement et interprétés par un autre FrameworkElement
parent de conteneur (généralement une classe dérivée de ContentControl ou une classe dérivée de Panel , ou peut-être un présentateur). La définition de propriétés d’alignement sur un élément enfant ne garantit pas que quoi que ce soit se produise ; le comportement dépend de la composition de la disposition et des éléments parents impliqués.
Lorsque les propriétés Height et Width sont explicitement définies ou calculées sur un objet, ces mesures sont plus importantes pour la logique de disposition classique et peuvent annuler les effets de la définition de la valeur VerticalAlignment
Stretch. Les propriétés de contrainte de disposition (telles que MaxHeight) affectent également la taille de disposition maximale ou minimale d’une Stretch
situation de disposition.
Stretch
est la valeur par défaut afin qu’il soit plus facile d’utiliser des techniques de disposition adaptative dans les cas où il n’y a pas de mesure explicite. Mais s’il y Height
a ou Width
découpage, la disposition agit comme si la valeur était Top
pour VerticalAlignment
, généralement Left
pour HorizontalAlignment (Right
pour les informations de culture de droite à gauche ou les valeurs FlowDirection explicites). Pour plus d’informations, voir Alignement, marge et espacement.
Le canevas n’utilise VerticalAlignment
pas lors de la composition de la disposition, car Canvas
est basé sur le positionnement absolu. En général, la valeur de VerticalAlignment
est potentiellement traitée différemment par tout objet capable d’avoir un ou plusieurs objets FrameworkElement comme contenu enfant. Chaque objet parent peut avoir sa propre logique de disposition.
Chaque élément d’interface utilisateur XAML peut appliquer cette propriété différemment en fonction des éléments de définition de style pour le style implicite. La « valeur par défaut » apparente pour VerticalAlignment
dans chaque élément d’interface utilisateur peut être différente. Par exemple, un contrôle Button commence par la valeur Center
. Si l’élément d’interface utilisateur est un contrôle, la VerticalAlignment
valeur peut également affecter le modèle visuel du contrôle.
Dans les contrôles de contenu, le modèle de contrôle utilise souvent des expressions d’extension de balisage {TemplateBinding} pour lier la propriété VerticalContentAlignment à une propriété sur un VerticalAlignment
élément de son modèle, tel que le présentateur ou l’élément utilisé comme zone de contenu.