FrameworkElement.Width Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Ruft die Breite des Elements ab bzw. legt diese fest.

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

Eigenschaftswert

Double

Die Breite des Elements in geräteunabhängigen Einheiten (1/96 Zoll pro Einheit). Der Standardwert ist NaN. Dieser Wert muss größer oder gleich 0,0 sein. Informationen zur Obergrenze finden Sie unter „Hinweise“.

Attribute

TypeConverterAttribute LocalizabilityAttribute

Hinweise

Dies ist eine von drei Eigenschaften für FrameworkElement die Angabe von Breiteninformationen. Die beiden anderen sind MinWidth und MaxWidth. Wenn es einen Konflikt zwischen diesen Werten gibt, muss die Anwendungsreihenfolge für die tatsächliche Breitenermittlung zuerst MinWidth berücksichtigt werden, dann MaxWidthund schließlich, wenn sich jeder dieser Werte innerhalb von Grenzen befindet, Width.

Der Rückgabewert dieser Eigenschaft ist immer mit jedem Wert identisch, der darauf festgelegt wurde. Im Gegensatz dazu kann der Wert des ActualWidth variieren. Das Layout hat die vorgeschlagene Größe möglicherweise aus irgendeinem Grund abgelehnt. Außerdem arbeitet das Layoutsystem selbst asynchron relativ zum Eigenschaftensystemsatz von Width und hat möglicherweise noch nicht die Änderung der bestimmten Größeneigenschaft verarbeitet.

Neben akzeptablen Double Werten kann diese Eigenschaft auch sein Double.NaN. So geben Sie das Verhalten der automatischen Größenanpassung an. In XAML legen Sie den Wert auf die Zeichenfolge "Auto" (ohne Beachtung der Groß-/Kleinschreibung) fest, um das Verhalten der automatischen Größenanpassung zu aktivieren. Das Automatische Größenanpassungsverhalten impliziert, dass das Element die verfügbare Breite ausfüllt. Beachten Sie jedoch, dass bestimmte Steuerelemente häufig Standardwerte in ihren Standardformaten bereitstellen, die das Verhalten der automatischen Größenanpassung deaktivieren, es sei denn, es wird ausdrücklich wieder aktiviert.

Zusätzlich zur Überprüfung gibt es eine nichtdeterministische Oberwertbindung, die Width vom Layoutsystem erzwungen wird (dies ist eine sehr große Zahl, größer als Single.MaxValue , aber kleiner als Double.MaxValue). Wenn Sie diese Grenze überschreiten, wird das Element nicht gerendert, und es wird keine Ausnahme ausgelöst. Legen Sie nicht auf einen Wert fest Width , der wesentlich größer als die maximale Größe einer möglichen visuellen Anzeige ist, oder Sie können diese nichtdeterministische Obergrenze überschreiten.

Verwendung von XAML-Attributen

<object Width="double"/>  

- oder -

<object Width ="qualifiedDouble"/>  

- oder -

<object Width ="Auto"/>  

XAML-Werte

double
Double

Zeichenfolgendarstellung eines Double Werts gleich oder größer als 0,0. Informationen zur Obergrenze finden Sie unter „Hinweise“. Dieser Wert wird als geräteunabhängige Einheitsmessung (1/96 Zoll) interpretiert. Zeichenfolgen müssen nicht explizit Dezimalpunkte enthalten. Für instance ist ein Wert von 1 akzeptabel.

qualifiedDouble
Ein double-Wert wie oben beschrieben, gefolgt von einer der folgenden Einheitendeklarationszeichenfolgen: px, in, cm, pt.

px (Standard) ist geräteunabhängige Einheiten (1/96 Zoll pro Einheit)

in ist Zoll; 1in==96px

cm ist Zentimeter; 1cm==(96/2.54) px

pt punkte; 1pt==(96/72) px

Auto
Aktiviert das Autoisierungsverhalten. Siehe Hinweise.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	WidthProperty
Metadateneigenschaften auf true festgelegt	AffectsMeasure