FrameworkElement.MaxWidth Eigenschaft

Definition

Namespace:

Windows.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 sein, der gleich oder größer als 0 ist. 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) teilen 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 Breiteinformationen angeben. Die beiden anderen sind MinWidth und Width. Wenn es einen Konflikt zwischen diesen Werten gibt, ist die Reihenfolge der Anwendung für die tatsächliche Breitenermittlung, dass zuerst MinWidth , dann MaxWidth und schließlich, wenn es sich innerhalb der Grenzen befindet, Width berücksichtigt werden muss. 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 MaxWidth überschreiten. Wenn beispielsweise UseLayoutRounding auf true festgelegt ist und Ihre App auf einem Display mit einer Auflösungsskala von mehr als 100 % ausgeführt wird, wird die ActualWidth möglicherweise aufgerundet, um sicherzustellen, dass Ihre Benutzeroberfläche beim Skalieren nicht verschwommen aussieht.

Weitere Informationen

• Width
• MinWidth
• Definieren von Layouts mit XAML