FrameworkElement.MaxHeight Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Ottiene o imposta il vincolo di altezza massima di un oggetto FrameworkElement.

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

double MaxHeight();

void MaxHeight(double value);

public double MaxHeight { get; set; }

var double = frameworkElement.maxHeight;
frameworkElement.maxHeight = double;

Public Property MaxHeight As Double

<frameworkElement MaxHeight="double"/>
 

Valore della proprietà

Double

double

Altezza massima dell'oggetto, in pixel. Il valore predefinito è PositiveInfinity. Questo valore può essere qualsiasi valore uguale o maggiore di 0. PositiveInfinity è anche valido.

Esempio

In questo esempio XAML viene illustrata una tecnica per specificare un MaxHeight oggetto per un controllo ViewBox. ViewBox è un elemento Decorator che può applicare informazioni di layout a un singolo elemento figlio e dividere le aree di layout per l'elemento padre successivo (in questo 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>

Commenti

MaxHeight è una delle tre proprietà scrivibili in FrameworkElement che specificano le informazioni sull'altezza. Gli altri due sono Height e MinHeight. Se si verifica un conflitto tra questi valori, l'ordine di applicazione per la determinazione effettiva dell'altezza è che prima MinHeight deve essere rispettato, quindi MaxHeighte infine, se si trova all'interno di limiti, Height. Tutte queste proprietà sono consigli per il comportamento del layout dell'elemento padre nell'albero degli oggetti. L'altezza dell'oggetto dopo l'esecuzione del layout è disponibile come valore della proprietà ActualHeight .

L'elemento ActualHeight finale di un elemento può superare MaxHeight. Ad esempio, se UseLayoutRounding è impostato su true e l'app è in esecuzione su uno schermo con scala di risoluzione maggiore del 100%, actualHeight può essere arrotondato per garantire che l'interfaccia utente non sembri sfocata quando viene ridimensionata.

Vedi anche

• ActualHeight
• Height
• MinHeight
• Definire layout con XAML