FrameworkElement.HorizontalAlignment 屬性

定義

命名空間:

Microsoft.UI.Xaml

取得或設定在版面配置父系中撰寫時套用至 FrameworkElement 的水準對齊特性，例如面板或專案控制項。

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

屬性值

HorizontalAlignment

此水平對齊方式設定作為列舉值。 預設值為 Stretch。

範例

在此範例中，值 Center 會指派給 HorizontalAlignment 和 VerticalAlignment，以將 TextBlock 元素放在 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>

備註

對齊屬性旨在提示所需的版面配置到調適型配置容器。 它們通常是在 FrameworkElement 子系上設定，並由另一個 FrameworkElement 容器父系解譯， (通常是 ContentControl 衍生類別或 Panel 衍生類別，或可能是簡報者) 。 在子專案上設定對齊屬性不保證會發生任何事;行為取決於配置組合和涉及的父元素。

當物件上明確設定或計算 Height 和 Width 屬性時，這些度量對一般版面配置邏輯而言更為重要，而且可以取消設定 HorizontalAlignment 為 Stretch的效果。 配置條件約束屬性 (例如 MaxWidth) 也會影響配置情況的版面配置大小 Stretch 上限或下限。 Stretch 是預設值，因此在沒有任何明確度量的情況下，更容易使用調適型配置技術。 但是，如果有Height和Width或裁剪，則版面配置就像是VerticalAlignment的值 Top 一樣，通常是 Left 針對 HorizontalAlignment 由右至左文化特性資訊 (Right ，或) 明確的FlowDirection值。 如需詳細資訊，請參閱對齊、邊界及邊框間距。

畫布 在撰寫版面配置時不會使用 HorizontalAlignment ，因為 Canvas 是以絕對位置為基礎。 一般而言，任何能夠讓一或多個FrameworkElement物件做為子內容的物件，可能會以不同的方式處理 的值 HorizontalAlignment 。 每個這類父物件都可以有自己的版面配置邏輯。

每個 XAML UI 元素可能會根據隱含 樣式的 Style setter，以不同的方式套用此屬性。 每個 UI 元素中的明顯「預設值」 HorizontalAlignment 可能不同。 例如， Button 控制項會以 值 Left 開頭。 如果 UI 元素是控制項，該值 HorizontalAlignment 也可能會影響控制項的視覺範本。

在內容控制項中，控制項範本通常會使用 {TemplateBinding} 標記延伸 運算式，將 HorizontalContentAlignment 屬性系結至 HorizontalAlignment 其範本內某些元素上的屬性，例如簡報者或做為內容區域的元素。

另請參閱

• Width
• VerticalAlignment
• 對齊、邊界及邊框間距