FrameworkElement.VerticalAlignment property

Gets or sets the vertical alignment characteristics that are applied to a FrameworkElement when it is composed in a parent object such as a panel or items control.

Syntax

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

<frameworkElement VerticalAlignment="verticalAlignmentMemberName"/>

XAML Values

verticalAlignmentMemberName

A constant name from the VerticalAlignment enumeration, for example Top.

Property value

Type: VerticalAlignment

A vertical alignment setting as a value of the enumeration. The default is Stretch.

Remarks

When the Height and Width properties are explicitly set on an object, those measurements are more important to typical layout logic, and can cancel the effects of setting VerticalAlignment to Stretch.

Canvas does not use VerticalAlignment when composing layout, because Canvas is based on absolute positioning. In general, the value of VerticalAlignment is potentially treated differently by any object that is capable of having one or more FrameworkElement objects as child content and has its own layout logic.

Examples

In this example, the value Center is assigned to HorizontalAlignment and VerticalAlignment to position the TextBlock elements in the center of the Grid cells.

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

Requirements

See also

FrameworkElement

Build date: 1/31/2013