FrameworkElement.Width Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Recupera o imposta la larghezza dell'elemento.

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à

Double

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

Attributi

TypeConverterAttribute LocalizabilityAttribute

Commenti

Questa è 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 dell'applicazione per la determinazione effettiva della larghezza deve essere innanzitutto MinWidth rispettato, quindi MaxWidth, e infine se ognuna di queste sono entro limiti, Width.

Il valore restituito di questa proprietà è sempre uguale a qualsiasi valore impostato su di esso. Al contrario, il valore dell'oggetto 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 sistema delle proprietà di Width e potrebbe non aver elaborato la modifica della proprietà di ridimensionamento specifica.

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 si imposta il valore 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 negli stili predefiniti che disabilitano il comportamento di ridimensionamento automatico, a meno che non sia abilitato in modo specifico.

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

Uso della sintassi XAML per gli attributi

<object Width="double"/>  

-oppure-

<object Width ="qualifiedDouble"/>  

-oppure-

<object Width ="Auto"/>  

Valori XAML

double
Double

Rappresentazione 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 unità indipendente dal dispositivo (1/96° pollice). Le stringhe non devono includere in modo esplicito i punti decimali. Ad esempio, un valore di 1 è accettabile.

qualificatoDouble
Valore doppio come descritto in precedenza, seguito da una delle stringhe di dichiarazione di unità seguenti: px, in, cm, pt.

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

in è pollici; 1in==96px

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 proprietà di dipendenza

Campo Identificatore	WidthProperty
Proprietà dei metadati impostate su true	AffectsMeasure