FrameworkElement.MaxWidth 屬性

定義

命名空間:

Microsoft.UI.Xaml

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

屬性值

Double

double

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

範例

這個 XAML 範例顯示指定ViewBox的 技術 MaxWidth 。 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>

備註

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

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

另請參閱

• Width
• MinWidth
• 使用 XAML 定義版面配置