FrameworkElement.VerticalAlignment 屬性

定義

命名空間:

Windows.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。

範例

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

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

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

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

另請參閱

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