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

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

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

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

另请参阅

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