FrameworkElement.MaxHeight 屬性

定義

命名空間:

Windows.UI.Xaml

取得或設定 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"/>
 

屬性值

Double

double

物件的最大高度，以圖元為單位。 預設值為 PositiveInfinity。 此值可以是等於或大於 0 的任何值。 PositiveInfinity 也有效。

範例

這個 XAML 範例顯示指定 ViewBox MaxHeight 的技術。 ViewBox 是一種裝飾專案，可將版面配置資訊套用至單一子系，並將下一個父元素的配置區域分割 (在此案例中為 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>

備註

MaxHeight 是 FrameworkElement 上三個可寫入屬性之一，可指定高度資訊。 其他兩個是 Height 和 MinHeight。 如果這些值之間發生衝突，則實際高度判斷的應用程式順序是必須接受第一個 MinHeight，然後 MaxHeight ，最後，如果是在界限內， 則為 Height。 所有這些屬性都是物件樹狀結構中元素父系的配置行為建議。 配置執行之後物件的高度可做為 ActualHeight 屬性值。

元素的最終 ActualHeight 可能超過 MaxHeight。 例如，如果 UseLayoutRounding 設定為 true ，且您的應用程式在解析度調整大於 100% 的顯示器上執行， 則 ActualHeight 可能會四捨五入，以協助確保 UI 在縮放時不會模糊。

另請參閱

• ActualHeight
• Height
• MinHeight
• 使用 XAML 定義版面配置