FrameworkElement.VerticalAlignment Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

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, um VerticalAlignment die TextBlock-Elemente in der Mitte der Rasterzellen zu positionieren.

<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 für einen adaptiven Layoutcontainer angeben. Sie werden in der Regel auf untergeordnete FrameworkElement-Elemente festgelegt und von einem anderen übergeordneten FrameworkElement Container interpretiert (in der Regel eine von ContentControl abgeleitete Klasse oder eine von Panel abgeleitete Klasse oder vielleicht ein Referenten). Das Festlegen von Ausrichtungseigenschaften für ein untergeordnetes Element ist keine Garantie dafür, dass etwas passiert. das Verhalten hängt von der Layoutkomposition und den beteiligten übergeordneten Elementen ab.

Wenn die Eigenschaften Höhe und Breite explizit für ein Objekt festgelegt oder berechnet werden, sind diese Messungen für die typische Layoutlogik wichtiger und können die Auswirkungen der Einstellung VerticalAlignment auf Stretch aufheben. Layouteinschränkungseigenschaften (z. B. MaxHeight) wirken sich auch auf die maximale oder minimale Layoutgröße für eine Stretch Layoutsituation aus. Stretch ist die Standardeinstellung, sodass es einfacher ist, adaptive Layouttechniken in Fällen zu verwenden, in denen keine explizite Messung erfolgt. Wenn jedoch und HeightWidth oder clipping vorhanden sind, verhält sich das Layout so, als ob der Wert für VerticalAlignmentgiltTop, normalerweise Left für HorizontalAlignment (Right für Kulturinformationen von rechts nach links oder explizite FlowDirection-Werte). Weitere Informationen hierzu finden Sie unter Ausrichtung, Rand und Abstand.

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

Jedes XAML-UI-Element kann diese Eigenschaft basierend auf den Stilsettern für den impliziten Stil unterschiedlich anwenden. Der scheinbare "Standardwert" für VerticalAlignment in jedem UI-Element kann unterschiedlich sein. Ein Button-Steuerelement beginnt beispielsweise mit dem Wert Center. Wenn das Ui-Element ein Steuerelement ist, kann sich der VerticalAlignment Wert auch auf die visuelle Vorlage des Steuerelements auswirken.

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

Weitere Informationen

• Width
• HorizontalAlignment
• Ausrichtung, Rand und Abstand