FrameworkElement.HorizontalAlignment 屬性

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

屬性值

水平對齊設定，作為列舉的值。 預設是 伸展。

範例

在此範例中，值 Center 被指派給 HorizontalAlignment 和 垂直對齊，將 TextBlock 元素置於 網格 格子的中央。

<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 衍生類別，或可能是呈現者）來解讀。 在子元素上設定對齊屬性並不保證會發生任何事;行為取決於版面組合及涉及的父元素。

當高度與寬度屬性被明確設定或計算於物件時，這些測量對典型的佈局邏輯更為重要，且能抵消設定HorizontalAlignment為拉伸的影響。 版面約束屬性（如 MaxWidth）也會影響版面情境下 Stretch 的最大或最小版面大小。 Stretch 預設值是為了在沒有明確測量的情況下，更容易使用自適應版面技術。 但如果有 Height 和 Width 或裁剪，版面會當作 VerticalAlignment 的值Top，通常是 Left （ HorizontalAlignmentRight 用於右向左文化資訊或明確的 FlowDirection 值）。 如需詳細資訊，請參閱 對齊、邊界和邊框間距。

Canvas 在排版時不使用 HorizontalAlignment ，因為 Canvas 是基於絕對位置。 一般而言，任何能將一個或多個 FrameworkElement 物件視為子內容的物件，可能會以不同的方式處理 的HorizontalAlignment值。 每個此類父物件都可以有自己的佈局邏輯。

每個 XAML UI 元素可能會根據隱含樣式的 樣式 設定器，對此屬性的應用不同。 每個 UI 元素中看似的「預設值」 HorizontalAlignment 可能不同。 例如， 按鈕 控制項以 開頭 Left為 。 如果 UI 元素是控制項，該 HorizontalAlignment 值也可能影響控制項的視覺範本。

在內容控制中，控制範本通常使用 {TemplateBinding} 標記擴充 表達式，將 HorizontalContentAlignment 屬性綁定到 HorizontalAlignment 模板內某元素的屬性，例如呈現者或用作內容區域的元素。

另請參閱

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