FrameworkElement.MaxWidth Propiedad

Definición

Espacio de nombres:

Microsoft.UI.Xaml

Obtiene o establece la restricción de ancho máximo de un FrameworkElement.

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

double MaxWidth();

void MaxWidth(double value);

public double MaxWidth { get; set; }

var double = frameworkElement.maxWidth;
frameworkElement.maxWidth = double;

Public Property MaxWidth As Double

<frameworkElement MaxWidth="double"/>
 

Valor de propiedad

Double

double

Ancho máximo del objeto, en píxeles. El valor predeterminado es PositiveInfinity. Este valor puede ser cualquier valor igual o mayor que 0. PositiveInfinity también es válido.

Ejemplos

En este ejemplo XAML se muestra una técnica de especificación MaxWidth de para un ViewBox. ViewBox es un decorador que puede aplicar información de diseño a un único elemento secundario y dividir áreas de diseño para el siguiente elemento primario (en este caso, stackPanel).

<Grid Height="600" Width="600">
    <Grid.ColumnDefinitions>
        <ColumnDefinition />
        <ColumnDefinition />
    </Grid.ColumnDefinitions>
    
    <Grid.RowDefinitions>
        <RowDefinition Height="Auto" />
        <RowDefinition Height="auto" />
        <RowDefinition />
    </Grid.RowDefinitions>
    
    <StackPanel Grid.Row="0" Grid.Column="0" Margin="5,5,5,5" Orientation="Vertical">
        <TextBlock Text="Stretch" FontWeight="Bold" FontSize="12" />
        <Button Name="btn1" Click="stretchNone" Content="None" />
        <Button Name="btn2" Click="stretchFill" Content="Fill" />
        <Button Name="btn3" Click="stretchUni" Content="Uniform" />
        <Button Name="btn4" Click="stretchUniFill" Content="UniformToFill" />
    </StackPanel>

    <StackPanel Grid.Row="0" Grid.Column="1" Margin="5,5,5,5" Orientation="Vertical">
        <TextBlock Text="StretchDirection" FontWeight="Bold" FontSize="12" />
        <Button Name="btn5" Click="sdUpOnly" Content="UpOnly" />
        <Button Name="btn6" Click="sdDownOnly" Content="DownOnly" />
        <Button Name="btn7" Click="sdBoth" Content="Both" />
    </StackPanel>

    <StackPanel Grid.Row="1" Grid.Column="0" Grid.ColumnSpan="2" Margin="5" 
                Orientation="Vertical">
        <TextBlock Name="txt1" FontSize="12" FontWeight="Bold" />
        <TextBlock Name="txt2" FontSize="12" FontWeight="Bold" />
    </StackPanel>   

    <StackPanel Grid.Row="2" Grid.Column="0" Grid.ColumnSpan="2" Margin="5" 
                Orientation="Horizontal">
        <Viewbox MaxWidth="100" MaxHeight="100" Name="vb1">
            <Image Source="flower.jpg"/>
        </Viewbox>
        <Viewbox MaxWidth="200" MaxHeight="200" Name="vb2">
            <Image Source="flower.jpg"/>
        </Viewbox>
        
        <Viewbox MaxWidth="300" MaxHeight="300" Name="vb3">
            <Image Source="flower.jpg"/>
        </Viewbox>
    </StackPanel>

</Grid>

Comentarios

MaxWidth es una de las tres propiedades grabables de FrameworkElement que especifican información de ancho. Los otros dos son MinWidth y Width. Si hay un conflicto entre estos valores, el orden de aplicación para la determinación de ancho real es que primero se debe respetar MinWidth , y MaxWidth, por último, si está dentro de los límites, Width. Todas estas propiedades son recomendaciones para el comportamiento de diseño del elemento primario en el árbol de objetos. El ancho del objeto después de que se ejecute el diseño está disponible como valor de la propiedad ActualWidth .

El elemento ActualWidth final de un elemento puede superar MaxWidth. Por ejemplo, si UseLayoutRounding está establecido true en y la aplicación se ejecuta en una pantalla con una escala de resolución superior al 100 %, el ActualWidth se puede redondear hacia arriba para ayudar a garantizar que la interfaz de usuario no se ve borrosa cuando se escala.

Consulte también

• Width
• MinWidth
• Definir diseños con XAML