Bagikan melalui

FrameworkElement.MaxWidth Properti

  • Referensi

Definisi

Ruang nama:
Microsoft.UI.Xaml
Edit

Mendapatkan atau mengatur batasan lebar maksimum 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"/>

Nilai Properti

Double

double

Lebar maksimum objek, dalam piksel. Defaultnya adalah PositiveInfinity. Nilai ini dapat berupa nilai apa pun yang sama dengan atau lebih besar dari 0. PositiveInfinity juga valid.

Contoh

Contoh XAML ini menunjukkan teknik menentukan MaxWidth untuk ViewBox. ViewBox adalah dekorator yang dapat menerapkan informasi tata letak ke satu anak dan membagi area tata letak untuk elemen induk berikutnya (dalam hal ini 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>

Keterangan

MaxWidth adalah salah satu dari tiga properti bisa-tulis pada FrameworkElement yang menentukan informasi lebar. Dua lainnya adalah MinWidth dan Width. Jika ada konflik antara nilai-nilai ini, urutan aplikasi untuk penentuan lebar aktual adalah bahwa MinWidth pertama harus dihormati, maka MaxWidth, dan akhirnya, jika berada dalam batas, Lebar. Semua properti ini adalah rekomendasi untuk perilaku tata letak induk elemen di pohon objek. Lebar objek setelah tata letak berjalan tersedia sebagai nilai properti ActualWidth .

ActualWidth akhir dari elemen mungkin melebihi MaxWidth. Misalnya, jika UseLayoutRounding diatur ke true dan aplikasi Anda berjalan pada layar dengan Skala Resolusi yang lebih besar dari 100%, maka ActualWidth dapat dibulatkan ke atas untuk membantu memastikan UI Anda tidak terlihat buram saat diskalakan.

Berlaku untuk

Lihat juga