FrameworkElement.VerticalAlignment 屬性

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

屬性值

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

範例

在此範例中，該值 Center 被分配給 HorizontalAlignment ，並將 VerticalAlignmentTextBlock 元素置於 格網 格中心。

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

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

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

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

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

另請參閱

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