FrameworkElement.MaxWidth 속성

정의

네임스페이스:

Windows.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%를 초과하는 디스플레이에서 앱이 실행되는 경우 크기 조정 시 UI가 흐리게 표시되지 않도록 ActualWidth 가 반올림될 수 있습니다.

추가 정보

• Width
• MinWidth
• XAML을 사용하여 레이아웃 정의