FrameworkElement.VerticalAlignment 屬性

定義

命名空間:

Microsoft.UI.Xaml

取得或設定在面板或專案控制項等父物件中撰寫時套用至 FrameworkElement 的垂直對齊特性。

public:
 property VerticalAlignment VerticalAlignment { VerticalAlignment get(); void set(VerticalAlignment value); };

VerticalAlignment VerticalAlignment();

void VerticalAlignment(VerticalAlignment value);

public VerticalAlignment VerticalAlignment { get; set; }

var verticalAlignment = frameworkElement.verticalAlignment;
frameworkElement.verticalAlignment = verticalAlignment;

Public Property VerticalAlignment As VerticalAlignment

<frameworkElement VerticalAlignment="verticalAlignmentMemberName"/>

屬性值

VerticalAlignment

垂直對齊設定，做為列舉值。 預設值為 Stretch。

範例

在此範例中，值 Center 會指派給 HorizontalAlignment ，並將 VerticalAlignmentTextBlock 元素放在 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 屬性時，這些度量對一般版面配置邏輯而言更為重要，而且可以取消設定 VerticalAlignment 為 Stretch的效果。 配置條件約束屬性 (，例如 MaxHeight) 也會影響配置情況的版面配置大小 Stretch 上限或下限。 Stretch 是預設值，因此在沒有任何明確度量的情況下，更容易使用調適型配置技術。 但是， Height 如果有 和 Width 或 裁剪，則版面配置就像 Top 是 針對 VerticalAlignment 的值，通常 Left 適用于 HorizontalAlignment (Right ，以向右至左的文化特性資訊或明確的 FlowDirection 值) 。 如需詳細資訊，請參閱對齊、邊界及邊框間距。

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

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

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

另請參閱

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