FrameworkElement.HorizontalAlignment Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

Ruft die horizontalen Ausrichtungsmerkmale ab, die auf ein FrameworkElement angewendet werden, wenn es in einem übergeordneten Layout zusammengesetzt wird, z. B. einem Panel- oder Elementsteuerelement.

public:
 property HorizontalAlignment HorizontalAlignment { HorizontalAlignment get(); void set(HorizontalAlignment value); };

HorizontalAlignment HorizontalAlignment();

void HorizontalAlignment(HorizontalAlignment value);

public HorizontalAlignment HorizontalAlignment { get; set; }

var horizontalAlignment = frameworkElement.horizontalAlignment;
frameworkElement.horizontalAlignment = horizontalAlignment;

Public Property HorizontalAlignment As HorizontalAlignment

<frameworkElement HorizontalAlignment="horizontalAlignmentMemberName"/>

Eigenschaftswert

HorizontalAlignment

Eine Einstellung für horizontale Ausrichtung als Wert der Enumeration. Der Standardwert ist Stretch.

Beispiele

In diesem Beispiel wird der Wert Center und VerticalAlignment zugewiesenHorizontalAlignment, um 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 HorizontalAlignment auf Stretch aufheben. Layouteinschränkungseigenschaften (z. B. MaxWidth) 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 es jedoch entweder Height und Width oder Clipping gibt, verhält sich das Layout so, als ob der Wert für VerticalAlignment giltTop, in der Regel Left für HorizontalAlignment (Right für Rechts-nach-links-Kulturinformationen oder explizite FlowDirection-Werte). Weitere Informationen hierzu finden Sie unter Ausrichtung, Rand und Abstand.

Canvas wird beim Verfassen von Layouts nicht verwendet HorizontalAlignment , da Canvas auf der absoluten Positionierung basiert. Im Allgemeinen wird der Wert von HorizontalAlignment 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 HorizontalAlignment in jedem UI-Element kann unterschiedlich sein. Ein Button-Steuerelement beginnt beispielsweise mit dem Wert Left. Wenn das Ui-Element ein Steuerelement ist, kann sich der HorizontalAlignment Wert auch auf die visuelle Vorlage des Steuerelements auswirken.

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

Weitere Informationen

• Width
• VerticalAlignment
• Ausrichtung, Rand und Abstand