FrameworkElement.VerticalAlignment Eigenschaft

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Ruft die vertikalen Ausrichtungsmerkmale ab, die auf ein FrameworkElement angewendet werden, wenn es in einem übergeordneten Objekt wie einem Panel- oder Elementsteuerelement zusammengesetzt ist, oder legt diese fest.

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

Eigenschaftswert

VerticalAlignment

Eine vertikale Ausrichtungseinstellung als Wert der Enumeration. Der Standardwert lautet Stretch.

Beispiele

In diesem Beispiel wird der Wert CenterHorizontalAlignment zugewiesen und VerticalAlignment die TextBlock-Elemente in der Mitte der Rasterzellen positioniert.

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

Hinweise

Ausrichtungseigenschaften sollen das gewünschte Layout auf einen adaptiven Layoutcontainer hinweisen. Sie werden in der Regel für untergeordnete FrameworkElement-Elemente festgelegt und von einem anderen FrameworkElement übergeordneten Container interpretiert (in der Regel eine von ContentControl abgeleitete Klasse oder eine von Panel abgeleitete Klasse oder vielleicht ein Referent). Das Festlegen von Ausrichtungseigenschaften für ein untergeordnetes Element ist keine Garantie dafür, dass etwas geschieht; das Verhalten hängt von der Layoutkomposition und den beteiligten übergeordneten Elementen ab.

Wenn die Eigenschaften "Height " und "Width " für ein Objekt explizit festgelegt oder berechnet werden, sind diese Maße für die typische Layoutlogik wichtiger und können die Auswirkungen der Einstellung VerticalAlignment auf "Stretch" abbrechen. Layouteinschränkungseigenschaften (z. B. MaxHeight) wirken sich auch auf die maximale oder minimale Layoutgröße für eine Stretch Layoutsituation aus. Stretch ist der Standardwert, damit adaptive Layouttechniken in den Fällen, in denen keine explizite Messung vorhanden ist, einfacher verwendet werden können. Wenn es jedoch eine Height oder Width einen Clipping gibt, verhält sich das Layout so, Left als ob der Wert für VerticalAlignmentHorizontalAlignmentRight ( für Informationen zur Leserichtung von rechts nach links oder explizite FlowDirection-Werte) istTop. Weitere Informationen finden Sie unter Ausrichtung, Rand und Abstand.

Canvas wird beim Verfassen des Layouts nicht verwendet VerticalAlignment , da Canvas sie auf absoluter Positionierung basiert. Im Allgemeinen wird der Wert potenziell VerticalAlignment von jedem Objekt unterschiedlich behandelt, das mindestens ein FrameworkElement-Objekt als untergeordneter Inhalt aufweisen kann. Jedes dieser übergeordneten Objekte kann über eine eigene Layoutlogik verfügen.

Jedes XAML-UI-Element kann diese Eigenschaft basierend auf den Style-Settern für die implizite Formatvorlage unterschiedlich anwenden. Der scheinbare "Standardwert" für VerticalAlignment jedes UI-Element kann unterschiedlich sein. Beispielsweise beginnt ein Button-Steuerelement mit dem Wert Center. Wenn das UI-Element ein Steuerelement ist, wirkt sich der VerticalAlignment Wert möglicherweise auch auf die visuelle Vorlage des Steuerelements aus.

In Inhaltssteuerelementen verwendet die Steuerelementvorlage häufig {TemplateBinding}-Markuperweiterungsausdrücke , um die VerticalContentAlignment-Eigenschaft an eine VerticalAlignment Eigenschaft eines Elements innerhalb der Vorlage zu binden, z. B. der Referent oder das Element, das als Inhaltsbereich verwendet wird.

Gilt für:

Weitere Informationen