FrameworkElement.VerticalAlignment Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml

Obtiene o establece las características de alineación vertical que se aplican a un FrameworkElement cuando se compone en un objeto primario, como un panel o un control de elementos.

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

Valor de propiedad

VerticalAlignment

Una configuración de alineación vertical, como un valor de la enumeración. El valor predeterminado es Stretch.

Ejemplos

En este ejemplo, el valor Center se asigna a HorizontalAlignment y VerticalAlignment para colocar los elementos TextBlock en el centro de las celdas 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>

Comentarios

Las propiedades de alineación están diseñadas para sugerir el diseño deseado a un contenedor de diseño adaptable. Normalmente se establecen en elementos secundarios FrameworkElement e interpretados por otro elemento primario del contenedor FrameworkElement (normalmente una clase derivada contentControl o una clase derivada de Panel , o quizás un moderador). Establecer propiedades de alineación en un elemento secundario no garantiza que suceda nada; el comportamiento depende de la composición del diseño y de los elementos primarios implicados.

Cuando las propiedades Height y Width se establecen o calculan explícitamente en un objeto, esas medidas son más importantes para la lógica de diseño típica y pueden cancelar los efectos de establecer VerticalAlignment en Stretch. Las propiedades de restricción de diseño (como MaxHeight) también afectan al tamaño de diseño máximo o mínimo para una situación de diseño stretch . Stretch es el valor predeterminado para que sea más fácil usar técnicas de diseño adaptable en los casos en los que no haya ninguna medida explícita. Pero si hay height y Width o clipping, el diseño actúa como si el valor es Top for VerticalAlignment, normalmente Left for HorizontalAlignment (Right for Right for right-to-left culture info or explicit FlowDirection values). Para obtener más información, consulta alineación, margen y espaciado.

Canvas no usa VerticalAlignment al redactar el diseño, ya que Canvas se basa en el posicionamiento absoluto. En general, el valor de VerticalAlignment puede tratarse de forma diferente por cualquier objeto que sea capaz de tener uno o varios objetos FrameworkElement como contenido secundario. Cada objeto primario puede tener su propia lógica de diseño.

Cada elemento de interfaz de usuario XAML puede aplicar esta propiedad de forma diferente en función de los establecedores de estilo para el estilo implícito. El "valor predeterminado" aparente para VerticalAlignment en cada elemento de la interfaz de usuario puede ser diferente. Por ejemplo, un control Button comienza con el valor Center. Si el elemento ui es un control, el valor VerticalAlignment también puede afectar a la plantilla visual del control.

En los controles de contenido, la plantilla de control suele usar expresiones de extensión de marcado {TemplateBinding} para enlazar la propiedad VerticalContentAlignment a una propiedad VerticalAlignment en algún elemento de su plantilla, como el moderador o el elemento usado como área de contenido.

Consulte también

• Width
• HorizontalAlignment
• Alineación, margen y espaciado