Windows Dev Center

Informazioni
L'argomento richiesto è visualizzato di seguito, ma non è incluso in questa libreria.

Proprietà FrameworkElement.MaxWidth

Aggiornamento: novembre 2007

Ottiene o imposta il vincolo di larghezza massima dell'elemento. Si tratta di una proprietà di dipendenza.

Spazio dei nomi:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)
XMLNS per 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 
                    Rappresentazione in forma di stringa di un valore Double uguale o maggiore di 0,0. Viene interpretato come una misura unità indipendente dal dispositivo (1/96 di pollice). Non è necessario che le stringhe includano in modo esplicito i separatori decimali. Ad esempio, un valore pari a 1 è accettabile. 
                
                    Valgono le stesse restrizioni di intervallo Double citate nella sezione Valore Proprietà, a meno che sia necessario utilizzare Estensione del markup x:Static per impostare il valore su PositiveInfinity.
                qualifiedDouble
                    Valore double come descritto in precedenza, seguito da una delle stringhe di dichiarazione di unità seguenti: px, in, cm, pt.
                 px (impostazione predefinita) equivale a unità indipendenti del dispositivo (1/96 di pollice per unità)
                 in equivale a pollici; 1in == 96px
                 cm equivale a centimetri; 1cm == (96/2,54) px
                 pt equivale a punti; 1pt == (96/72) px
                

Valore proprietà

Tipo: System.Double

Larghezza massima dell'elemento in unità indipendenti del dispositivo (1/96 di pollice per unità). Il valore predefinito è PositiveInfinity. Questo valore può essere qualsiasi valore uguale o maggiore di 0,0. È valido anche PositiveInfinity.

Campo dell'identificatore

MaxWidthProperty

Proprietà dei metadati impostate su true

AffectsMeasure

È una delle tre proprietà scrivibili in FrameworkElement che specificano informazioni sulla larghezza. Le altre due sono MinWidth e Width. Se esiste un conflitto tra questi valori, l'ordine di applicazione per determinare la larghezza effettiva è che deve essere prima applicata MinWidth, quindi MaxWidth e infine, se i limiti di ognuna sono rispettati, Width.

Le restrizioni di valore sul valore Double vengono applicate da un meccanismo ValidateValueCallback. Se si tenta di impostare un valore non valido, verrà generata un'eccezione in fase di esecuzione.

In questo esempio vengono illustrate le differenze nel comportamento di rendering tra le quattro proprietà correlate alla larghezza disponibili in Windows Presentation Foundation (WPF).

La classe FrameworkElement espone quattro proprietà che descrivono le caratteristiche di larghezza di un elemento. Queste quattro proprietà possono entrare in conflitto e, quando ciò si verifica, il valore che ha la precedenza è determinato come segue: il valore MinWidth ha la precedenza sul valore MaxWidth, che a sua volta ha la precedenza sul valore Width. La quarta proprietà, ActualWidth, è in sola lettura.

Negli esempi di Extensible Application Markup Language (XAML) seguenti viene tracciato un elemento Rectangle (rect1) come elemento figlio di Canvas. È possibile modificare le proprietà relative alla larghezza di un elemento Rectangle utilizzando una serie di oggetti ListBox che rappresentano i valori della proprietà di MinWidth, MaxWidth e Width. In questo modo, la precedenza di ogni proprietà viene visualizzata graficamente.

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


Negli esempi code-behind seguenti sono gestiti gli eventi generati dall'evento SelectionChanged. Ogni metodo personalizzato accetta l'input dall'oggetto ListBox, analizza il valore come Double e lo applica alla proprietà correlata alla larghezza specificata. I valori relativi alla larghezza vengono inoltre convertiti in una stringa e scritti in un elemento TextBlock denominato txt1.

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


Per l'esempio completo, vedere Esempio di confronto di proprietà Width.

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0

Aggiunte alla community

Mostra:
© 2015 Microsoft