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。

示例

在此示例中，值 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 属性时，这些度量对于典型的布局逻辑更重要，并且可能会取消将 VerticalAlignment 设置为 Stretch 的效果。 MaxHeight) 等布局约束属性 (也会影响拉伸布局情况下的最大或最小布局大小。 拉伸 是默认设置，以便在没有显式度量的情况下更轻松地使用自适应布局技术。 但是，如果存在 Height 和 Width 或剪裁，则布局的作用就像垂直对齐的值为 Top ，通常为 Left 表示 HorizontalAlignment (Right 表示区域性信息从右到左，或者) 显式 FlowDirection 值。 有关详细信息，请参阅对齐、边距和填充。

画布 在撰写布局时不使用 VerticalAlignment，因为 Canvas 基于绝对定位。 通常，任何能够将一个或多个 FrameworkElement 对象作为子内容的对象都可能会以不同的方式对待 VerticalAlignment 的值。 每个此类父对象都可以有自己的布局逻辑。

每个 XAML UI 元素可能会根据隐式 样式的样式 资源库以不同的方式应用此属性。 每个 UI 元素中 VerticalAlignment 的明显“默认值”可能不同。 例如， Button 控件以值 Center 开头。 如果 UI 元素是控件，则 VerticalAlignment 值也可能影响控件的可视模板。

在内容控件中，控件模板通常使用 {TemplateBinding} 标记扩展 表达式将 VerticalContentAlignment 属性绑定到其模板中某些元素（如演示者或用作内容区域的元素）上的 VerticalAlignment 属性。

另请参阅

• Width
• HorizontalAlignment
• 对齐、边距和填充