FrameworkElement.HorizontalAlignment 屬性

定義

命名空間:

Windows.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或 clipping，則版面配置會如同值是 VerticalAlignment 的Top，通常為Left 代表HorizontalAlignment (Right代表由右至左的文化特性資訊或明確的FlowDirection值) 。 如需詳細資訊，請參閱對齊、邊界及邊框間距。

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

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

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

另請參閱

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