Windows Dev Center

Informationen
Das angeforderte Thema wird unten angezeigt. Es ist jedoch nicht in dieser Bibliothek vorhanden.

FrameworkElement.MaxWidth-Eigenschaft

Aktualisiert: November 2007

Ruft die Einschränkung für die maximale Breite des Elements ab oder legt diese fest. Dies ist eine Abhängigkeitseigenschaft.

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)
XMLNS für XAML: http://schemas.microsoft.com/winfx/xaml/presentation

[TypeConverterAttribute(typeof(LengthConverter))]
[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
public double MaxWidth { get; set; }
/** @property */
/** @attribute TypeConverterAttribute(LengthConverter) */
/** @attribute LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable) */
public double get_MaxWidth()
/** @property */
/** @attribute TypeConverterAttribute(LengthConverter) */
/** @attribute LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable) */
public  void set_MaxWidth(double value)

public function get MaxWidth () : double
public function set MaxWidth (value : double)
<object MaxWidth="double"/>
- or -
<object MaxWidth="qualifiedDouble"/>
double
                    Double
                
                    Die Zeichenfolgendarstellung eines Double-Werts, der größer oder gleich 0,0 ist. Diese wird als geräteunabhängige Einheit (1/96 Zoll)-Maß interpretiert. Zeichenfolgen müssen nicht explizit Dezimaltrennzeichen enthalten. Der Wert 1 ist z. B. zulässig. 
                
                    Es gelten die gleichen Beschränkungen für den Double-Bereich wie im Abschnitt zu den Eigenschaftenwerten. Zum Festlegen des Werts auf PositiveInfinity müssen Sie jedoch x:Statische Markuperweiterung verwenden.
                qualifiedDouble
                    Ein double-Wert, wie oben beschrieben, auf den eine der folgenden Zeichenfolgen zur Einheitendeklaration folgt: px, in, cm, pt.
                
                    px (Standardwert) ist geräteunabhängige Einheiten (1/96th inch per unit)
                
                    in ist Zoll, 1 Zoll == 96 px
                
                    cm ist Zentimeter, 1 cm == (96/2,54) px
                
                    pt ist Punkt, 1 pt == (96/72) px
                

Eigenschaftenwert

Typ: System.Double
Die maximale Breite des Elements in geräteunabhängige Einheiten (1/96th inch per unit). Der Standardwert ist PositiveInfinity. Dieser Wert kann ein beliebiger Wert größer oder gleich 0,0 sein. PositiveInfinity ist ebenfalls zulässig.

Bezeichnerfeld

MaxWidthProperty

Auf true festgelegte Metadateneigenschaften

AffectsMeasure

Dies ist eine der drei Eigenschaften von FrameworkElement zum Angeben von Breiteninformationen. Bei den anderen beiden handelt es sich um MinWidth und Width. Wenn ein Konflikt zwischen diesen Werten vorliegt, lautet die Anwendungsreihenfolge zur Bestimmung der tatsächlichen Breite wie folgt: MinWidth, dann MaxWidth und schließlich, wenn beide innerhalb der Grenzen liegen, Width.

Die Wertbeschränkungen für den Double-Wert werden von einem ValidateValueCallback-Mechanismus erzwungen. Wenn Sie versuchen, einen ungültigen Wert festzulegen, wird eine Laufzeitausnahme ausgelöst.

In diesem Beispiel werden die Unterschiede im Renderingverhalten zwischen den vier breitenbezogenen Eigenschaften in Windows Presentation Foundation (WPF) visuell veranschaulicht.

Die Breitenmerkmale eines Elements werden von vier Eigenschaften beschrieben, die von der FrameworkElement-Klasse verfügbar gemacht werden. Diese vier Eigenschaften können zu Konflikten führen. Sollte dies der Fall sein, wird der vorrangige Wert folgendermaßen definiert: Der MinWidth-Wert hat Vorrang vor dem MaxWidth-Wert, der wiederum Vorrang vor dem Width-Wert hat. Die vierte Eigenschaft, ActualWidth, ist schreibgeschützt.

In den folgenden Extensible Application Markup Language (XAML)-Beispielen wird ein Rectangle-Element (rect1) als untergeordnetes Element der Canvas dargestellt. Die Breiteneigenschaften von einem Rectangle können mithilfe einer Reihe von ListBoxes verändert werden, die die Eigenschaftswerte von MinWidth, MaxWidth und Width darstellen. Auf diese Weise wird die Rangfolge jeder Eigenschaft visuell angezeigt.

<Canvas Height="200" MinWidth="200" Background="#b0c4de" VerticalAlignment="Top"  HorizontalAlignment="Center" Name="myCanvas">
    <Rectangle HorizontalAlignment="Center" Canvas.Top="50" Canvas.Left="50"  Name="rect1" Fill="#4682b4" Width="100" Height="100"/>
</Canvas>


...

    <TextBlock Grid.Row="1" Grid.Column="0" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle Width:</TextBlock>
    <ListBox Grid.Column="1" Grid.Row="1" Margin="10,0,0,0" Width="50" Height="50" SelectionChanged="changeWidth">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem>
      <ListBoxItem>225</ListBoxItem>
      <ListBoxItem>250</ListBoxItem>
    </ListBox>

	<TextBlock Grid.Row="1" Grid.Column="2" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle MinWidth:</TextBlock>
    <ListBox Grid.Column="3" Grid.Row="1" Margin="10,0,0,0" Width="50" Height="50" SelectionChanged="changeMinWidth">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem>
      <ListBoxItem>225</ListBoxItem>
      <ListBoxItem>250</ListBoxItem>
  </ListBox>      

    <TextBlock Grid.Row="1" Grid.Column="4" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle MaxWidth:</TextBlock>
    <ListBox Grid.Column="5" Grid.Row="1" Margin="10,0,0,0" Width="50" Height="50" SelectionChanged="changeMaxWidth">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem>
      <ListBoxItem>225</ListBoxItem>
      <ListBoxItem>250</ListBoxItem>  
    </ListBox>


In den folgenden CodeBehind-Beispielen werden die Ereignisse behandelt, die das SelectionChanged-Ereignis auslöst. Jede benutzerdefinierte Methode übernimmt die Eingabe vom ListBox, analysiert den Wert als Double und wendet den Wert auf die angegebene breitenbezogene Eigenschaft an. Die Breitenwerte werden auch in eine Zeichenfolge konvertiert und in ein TextBlock-Element mit dem Namen txt1 geschrieben.

private void changeWidth(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.Width = sz1;
    rect1.UpdateLayout();
    txt1.Text = "ActualWidth is set to " + rect1.ActualWidth;
    txt2.Text = "Width is set to " + rect1.Width;
    txt3.Text = "MinWidth is set to " + rect1.MinWidth;
    txt4.Text = "MaxWidth is set to " + rect1.MaxWidth;
}
private void changeMinWidth(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.MinWidth = sz1;
    rect1.UpdateLayout();
    txt1.Text = "ActualWidth is set to " + rect1.ActualWidth;
    txt2.Text = "Width is set to " + rect1.Width;
    txt3.Text = "MinWidth is set to " + rect1.MinWidth;
    txt4.Text = "MaxWidth is set to " + rect1.MaxWidth;
}
private void changeMaxWidth(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.MaxWidth = sz1;
    rect1.UpdateLayout();
    txt1.Text = "ActualWidth is set to " + rect1.ActualWidth;
    txt2.Text = "Width is set to " + rect1.Width;
    txt3.Text = "MinWidth is set to " + rect1.MinWidth;
    txt4.Text = "MaxWidth is set to " + rect1.MaxWidth;
}


Das vollständige Beispiel finden Sie unter Beispiel für den Vergleich von Breiteneigenschaften.

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0

Community-Beiträge

Anzeigen:
© 2015 Microsoft