FrameworkElement.Width Proprietà

public:
 property double Width { double get(); void set(double value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Width { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Width : double with get, set

Public Property Width As Double

Valore della proprietà

Larghezza dell'elemento, in unità indipendenti dal dispositivo (1/96° pollice per unità). Il valore predefinito è NaN. Questo valore deve essere uguale o maggiore di 0,0. Per informazioni sul limite superiore, vedere La sezione Osservazioni.

Attributi

TypeConverterAttribute LocalizabilityAttribute

Commenti

Si tratta di una delle tre proprietà in cui specificare le informazioni sulla FrameworkElement larghezza. Gli altri due sono MinWidth e MaxWidth. Se si verifica un conflitto tra questi valori, l'ordine di applicazione per la determinazione effettiva della larghezza deve essere prima MinWidth rispettato, quindi MaxWidthe infine se ognuno di questi valori si trova all'interno di limiti, Width.

Il valore restituito di questa proprietà è sempre uguale a qualsiasi valore impostato su di esso. Al contrario, il valore di ActualWidth può variare. Il layout potrebbe aver rifiutato le dimensioni suggerite per qualche motivo. Inoltre, il sistema di layout stesso funziona in modo asincrono rispetto al set di sistemi di proprietà di Width e potrebbe non aver ancora elaborato tale modifica specifica della proprietà di ridimensionamento.

Oltre ai valori accettabili Double , questa proprietà può anche essere Double.NaN. Questo è il modo in cui si specifica il comportamento di ridimensionamento automatico. In XAML il valore viene impostato sulla stringa "Auto" (senza distinzione tra maiuscole e minuscole) per abilitare il comportamento di ridimensionamento automatico. Il comportamento di ridimensionamento automatico implica che l'elemento riempirà la larghezza disponibile. Si noti tuttavia che i controlli specifici forniscono spesso valori predefiniti nei relativi stili predefiniti che disabiliteranno il comportamento di ridimensionamento automatico, a meno che non sia riabilitato in modo specifico.

Oltre al controllo di convalida, esiste un limite di valore superiore non deterministico per Width che viene applicato dal sistema di layout (si tratta di un numero molto elevato, maggiore di ma minore Single.MaxValue di Double.MaxValue). Se si supera questo limite, l'elemento non verrà eseguito il rendering e non verrà generata alcuna eccezione. Non impostare Width su un valore significativamente maggiore della dimensione massima di qualsiasi visualizzazione visiva possibile oppure è possibile superare questo limite superiore non deterministico.

Utilizzo degli attributi XAML

<object Width="double"/>

oppure

<object Width ="qualifiedDouble"/>

oppure

<object Width ="Auto"/>

Valori XAML

DoppiaDouble

Rappresentazione di stringa di un Double valore uguale o maggiore di 0,0. Per informazioni sul limite superiore, vedere La sezione Osservazioni. Questo valore viene interpretato come misura di unità indipendente dal dispositivo (1/96 pollici). Le stringhe non devono includere in modo esplicito i separatori decimali. Ad esempio, un valore di 1 è accettabile.

qualifiedDouble Valore double come descritto in precedenza, seguito da una delle stringhe di dichiarazione di unità seguenti: px, incm, , pt.

px (impostazione predefinita) è unità indipendenti dal dispositivo (1/96 pollici per unità)

in è pollici; 1in==96 px

cm è centimetri; 1cm==(96/2.54) px

pt è punti; 1pt==(96/72) px

Auto Abilita il comportamento di ridimensionamento automatico. Vedere la sezione Osservazioni.

Informazioni sulle proprietà di dipendenza