FrameworkElement.HorizontalAlignment Proprietà

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

Valore della proprietà

Impostazione di allineamento orizzontale, come valore dell'enumerazione . Il valore predefinito è Stretch.

Esempio

In questo esempio il valore Center viene assegnato a HorizontalAlignment e VerticalAlignment per posizionare gli elementi TextBlock al centro delle celle 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>

Commenti

Le proprietà di allineamento sono destinate a suggerire il layout desiderato a un contenitore di layout adattivo. Vengono in genere impostati sugli elementi figlio FrameworkElement e interpretati da un altro elemento padre del contenitore FrameworkElement (in genere una classe derivata contentControl o una classe derivata panel o forse un relatore). L'impostazione delle proprietà di allineamento su un elemento figlio non garantisce che ciò accada; il comportamento dipende dalla composizione del layout e dagli elementi padre coinvolti.

Quando le proprietà Height e Width vengono impostate o calcolate in modo esplicito su un oggetto, tali misurazioni sono più importanti per la logica di layout tipica e possono annullare gli effetti dell'impostazione su HorizontalAlignmentStretch. Le proprietà dei vincoli di layout(ad esempio MaxWidth) influiscono anche sulle dimensioni massime o minime del layout per una Stretch situazione di layout. Stretch è l'impostazione predefinita in modo che sia più facile usare tecniche di layout adattivo nei casi in cui non è presente alcuna misurazione esplicita. Tuttavia, se sono presenti altezza e larghezza o ritaglio, il layout agisce come se il valore sia Top per VerticalAlignment, in Left genere per (Right per HorizontalAlignment informazioni sulle impostazioni cultura da destra a sinistra o valori di FlowDirection espliciti). Per altre info, vedi Allineamento, margine e riempimento.

Canvas non viene usato HorizontalAlignment durante la composizione del layout, perché Canvas si basa sul posizionamento assoluto. In generale, il valore di HorizontalAlignment viene potenzialmente trattato in modo diverso da qualsiasi oggetto in grado di avere uno o più oggetti FrameworkElement come contenuto figlio. Ogni oggetto padre può avere la propria logica di layout.

Ogni elemento dell'interfaccia utente XAML può applicare questa proprietà in modo diverso in base ai setter style per lo stile implicito. Il "valore predefinito" apparente per HorizontalAlignment in ogni elemento dell'interfaccia utente può essere diverso. Ad esempio, un controllo Button inizia con il valore Left. Se l'elemento dell'interfaccia utente è un controllo, il HorizontalAlignment valore potrebbe influire anche sul modello visivo del controllo.

Nei controlli contenuto, il modello di controllo usa spesso espressioni di estensione di markup {TemplateBinding} per associare la proprietà HorizontalContentAlignment a una proprietà in un HorizontalAlignment elemento all'interno del relativo modello, ad esempio il relatore o l'elemento utilizzato come area di contenuto.

Vedi anche

• Width
• VerticalAlignment
• allineamento, margine e spaziatura interna