FrameworkElement.HorizontalAlignment Eigenschaft

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

Eine horizontale Ausrichtungseinstellung 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 auf einen adaptiven Layoutcontainer hinweisen. Sie werden in der Regel für 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 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 HorizontalAlignment auf "Stretch" abbrechen. Layouteinschränkungseigenschaften (z. B. MaxWidth) 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 entweder Höhe und Breite oder Clipping gibt, verhält sich das Layout so, als ob der Wert für VerticalAlignment istTop, normalerweise Left für (Right für HorizontalAlignment Informationen zur Rechts-nach-links-Kultur oder explizite FlowDirection-Werte). Weitere Informationen finden Sie unter Ausrichtung, Rand und Abstand.

Canvas wird beim Verfassen des Layouts nicht verwendet HorizontalAlignment , da Canvas auf absoluter Positionierung basiert. Im Allgemeinen wird der Wert potenziell HorizontalAlignment 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 HorizontalAlignment jedes UI-Element kann unterschiedlich sein. Beispielsweise beginnt ein Button-Steuerelement mit dem Wert Left. Wenn das UI-Element ein Steuerelement ist, wirkt sich der HorizontalAlignment Wert möglicherweise auch auf die visuelle Vorlage des Steuerelements aus.

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

Weitere Informationen

• Width
• VerticalAlignment
• Ausrichtung, Rand und Abstand