FrameworkElement.MaxWidth Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

Ruft die Maximale Breiteseinschränkung eines FrameworkElements ab oder legt diese fest.

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

Eigenschaftswert

Double

double

Die maximale Breite des Objekts in Pixel. Der Standardwert ist PositiveInfinity. Dieser Wert kann ein beliebiger Wert gleich oder größer 0 sein. PositiveInfinity ist ebenfalls gültig.

Beispiele

Dieses XAML-Beispiel zeigt eine Technik zum Angeben eines MaxWidth für ein ViewBox-Objekt. ViewBox ist ein Decorator, der Layoutinformationen auf ein einzelnes untergeordnetes Element anwenden und Layoutbereiche für das nächste übergeordnete Element (in diesem Fall ein StackPanel) unterteilen kann.

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

Hinweise

MaxWidth ist eine von drei beschreibbaren Eigenschaften in FrameworkElement , die Width-Informationen angeben. Die anderen beiden sind MinWidth und Width. Wenn es einen Konflikt zwischen diesen Werten gibt, ist die Reihenfolge der Anwendung für die tatsächliche Breitenbestimmung, dass zuerst MinWidth berücksichtigt werden muss, dann MaxWidth, und schließlich, wenn es innerhalb der Grenzen liegt, Width. Alle diese Eigenschaften sind Empfehlungen für das Layoutverhalten des übergeordneten Elements in der Objektstruktur. Die Breite des Objekts nach der Layoutausführung ist als ActualWidth-Eigenschaftswert verfügbar.

Die endgültige ActualWidth eines Elements kann überschreiten MaxWidth. Wenn beispielsweise UseLayoutRounding auf true festgelegt ist und Ihre App auf einem Bildschirm mit einer Auflösungsskala von mehr als 100 % ausgeführt wird, kann ActualWidth aufgerundet werden, um sicherzustellen, dass Ihre Benutzeroberfläche beim Skalieren nicht verschwommen aussieht.

Weitere Informationen

• Width
• MinWidth
• Definieren von Layouts mit XAML