FrameworkElement.MaxWidth 屬性

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"/>
 

屬性值

物體的最大寬度，以像素為單位。 預設為 PositiveInfinity。 此值可以是任何等於或大於0的值。 正無限（PositiveInfinity ）也是有效的。

範例

這個 XAML 範例展示了一種為 ViewBox 指定 a 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）。 若這些值存在衝突，實際寬度判定的順序為：先遵守 最小寬 度，接 MaxWidth著是 ，最後若在範圍內則為 寬度。 所有這些屬性都是對物件樹中元素父節點配置行為的建議。 物件在執行版面後的寬度可作為 ActualWidth 屬性值取得。

元素的最終 實際寬 度可能超過 MaxWidth。 例如，如果 UseLayoutRound 設定 為 ， true 且你的應用程式在解析度 縮放 超過 100%的顯示器上運行，那麼 ActualWidth 可能會被向上取整，以確保縮放後 UI 不會模糊。

另請參閱

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