FrameworkElement.Width FrameworkElement.Width FrameworkElement.Width FrameworkElement.Width Property

Definizione

Recupera o imposta la larghezza dell'elemento.Gets or sets the width of the element.

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; }
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 di pollice per unità)device-independent units (1/96th inch per unit).The width of the element, in unità indipendenti dal dispositivo (1/96 di pollice per unità)device-independent units (1/96th inch per unit). Il valore predefinito è NaN.The default value is NaN. Questo valore deve essere maggiore o uguale a 0,0.This value must be equal to or greater than 0.0. Per informazioni sul limite superiore, vedere la sezione Osservazioni.See Remarks for upper bound information.

Commenti

Si tratta di una delle tre proprietà FrameworkElement di che specificano le informazioni sulla larghezza.This is one of three properties on FrameworkElement that specify width information. Gli altri due sono MinWidth e MaxWidth.The other two are MinWidth and MaxWidth. Se si verifica un conflitto tra questi valori, è necessario innanzitutto MinWidth rispettare l'ordine di applicazione per la determinazione della larghezza effettiva, quindi MaxWidth, e infine se ognuno di questi si trova all'interno dei limiti,. WidthIf there is a conflict between these values, the order of application for actual width determination is first MinWidth must be honored, then MaxWidth, and finally if each of these are within bounds, Width.

Il valore restituito di questa proprietà è sempre uguale a qualsiasi valore impostato.The return value of this property is always the same as any value that was set to it. Al contrario, il valore di ActualWidth può variare.In contrast, the value of the ActualWidth may vary. Per qualche motivo, il layout potrebbe avere rifiutato le dimensioni suggerite.The layout may have rejected the suggested size for some reason. Inoltre, il sistema di layout funziona in modo asincrono rispetto al set di sistemi di Width proprietà di e potrebbe non avere ancora elaborato la modifica della proprietà di ridimensionamento.Also, the layout system itself works asynchronously relative to the property system set of Width and may not have processed that particular sizing property change yet.

Oltre ai valori accettabili Double , questa proprietà può anche essere. Double.NaNIn addition to acceptable Double values, this property can also be Double.NaN. Questo è il modo in cui si specifica il comportamento di ridimensionamento automatico.This is how you specify auto sizing behavior. In XAMLXAML è possibile impostare il valore sulla stringa "auto" (senza distinzione tra maiuscole e minuscole) per abilitare il comportamento di dimensionamento automatico.In XAMLXAML you set the value to the string "Auto" (case insensitive) to enable the auto sizing behavior. Il comportamento di ridimensionamento automatico implica che l'elemento riempirà la larghezza disponibile.Auto sizing behavior implies that the element will fill the width available to it. Si noti tuttavia che i controlli specifici forniscono spesso i valori predefiniti negli stili predefiniti che disabilitano il comportamento di ridimensionamento automatico, a meno che non venga riabilitata in modo specifico.Note however that specific controls frequently supply default values in their default styles that will disable the auto sizing behavior unless it is specifically re-enabled.

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 Single.MaxValue , ma minore di Double.MaxValue).In addition to the validation check, there is a nondeterministic upper value bound for Width that is enforced by the layout system (this is a very large number, larger than Single.MaxValue but smaller than Double.MaxValue). Se si supera questo limite, l'elemento non verrà sottoposta a rendering e non verrà generata alcuna eccezione.If you exceed this bound, the element will not render, and no exception is thrown. Non impostare Width su un valore significativamente superiore alla dimensione massima di qualsiasi visualizzazione visiva possibile oppure è possibile che venga superato questo limite superiore non deterministico.Do not set Width to a value that is significantly larger than the maximum size of any possible visual display, or you may exceed this nondeterministic upper bound.

Uso della sintassi XAML per gli attributiXAML Attribute Usage

<object Width="double"/>  

-oppure--or-

<object Width ="qualifiedDouble"/>  

-oppure--or-

<object Width ="Auto"/>  

Valori XAMLXAML Values

doubledouble
Double

Rappresentazione di stringa di Double un valore uguale o maggiore di 0,0.String representation of a Double value equal to or greater than 0.0. Per informazioni sul limite superiore, vedere la sezione Osservazioni.See Remarks for upper bound information. Questo valore viene interpretato come una unità indipendente dal dispositivo (1/96 di pollice)device-independent unit (1/96th inch) misura.This value is interpreted as a unità indipendente dal dispositivo (1/96 di pollice)device-independent unit (1/96th inch) measurement. Le stringhe non devono includere in modo esplicito i punti decimali.Strings need not explicitly include decimal points. Ad esempio, il valore 1 è accettabile.For instance a value of 1 is acceptable.

qualifiedDoublequalifiedDouble
Un valore Double come descritto in precedenza, seguito da una delle stringhe di dichiarazione di unità pxseguenti: cm, pt in,,.A double value as described above, followed by one of the following unit declaration strings: px, in, cm, pt.

px(impostazione predefinita)unità indipendenti dal dispositivo (1/96 di pollice per unità)device-independent units (1/96th inch per unit)px (default) is unità indipendenti dal dispositivo (1/96 di pollice per unità)device-independent units (1/96th inch per unit)

inè in pollici; 1in = = 96pxin is inches; 1in==96px

cmè centimetro; 1 cm = = (96/2,54) pxcm is centimeters; 1cm==(96/2.54) px

ptpunti; 1Pt = = (96/72) pxpt is points; 1pt==(96/72) px

Auto
Abilita il comportamento di ridimensionamento automatico.Enables autosizing behavior. Vedere la sezione Osservazioni.See Remarks.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field WidthProperty
Proprietà dei metadati impostate sutrueMetadata properties set to true AffectsMeasure

Si applica a