FrameworkElement.MaxHeight Proprietà

Definizione

Spazio dei nomi:

Windows.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 oggetto MaxHeight 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 MaxHeight e infine, se è entro 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 potrebbe 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