FrameworkElement.Width Eigenschaft

Definition

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

Hinweise

Dies ist eine von drei Eigenschaften für FrameworkElement , die Breiteninformationen angeben. Die anderen beiden sind MinWidth und MaxWidth . Wenn es einen Konflikt zwischen diesen Werten gibt, muss zuerst die Reihenfolge der Anwendung für die Ermittlung der tatsächlichen Breite, dann und schließlich , wenn sich jeder dieser Werte innerhalb der Grenzen MinWidth MaxWidth befindet, zu sehen Width sein.

Der Rückgabewert dieser Eigenschaft ist immer identisch mit jedem Wert, der auf sie festgelegt wurde. Im Gegensatz dazu kann der Wert von ActualWidth variieren. Möglicherweise hat das Layout die vorgeschlagene Größe aus irgendeinem Grund abgelehnt. Darüber hinaus funktioniert das Layoutsystem selbst asynchron relativ zum Eigenschaftensystemsatz von und hat diese bestimmte Größenänderung möglicherweise noch Width nicht verarbeitet.

Zusätzlich zu den Double zulässigen Werten kann diese Eigenschaft auch Double.NaN sein. Auf diese Weise geben Sie das Verhalten bei der automatischen Größenisierung an. In XAML legen Sie den Wert auf die Zeichenfolge "Auto" fest (ohne Unterscheidung der Groß-/Kleinschreibung), um das Automatische Größenverhalten zu aktivieren. Automatisches Größenverhalten impliziert, dass das Element die breite ausfüllt, die ihm zur Verfügung steht. Beachten Sie jedoch, dass bestimmte Steuerelemente häufig Standardwerte in ihren Standardstilen festlegen, die das Automatische Größenverhalten deaktivieren, es sei denn, es wird ausdrücklich erneut aktiviert.

Zusätzlich zur Validierungsprüfung gibt es einen nicht deterministischen oberen Wert, der vom Layoutsystem erzwungen wird (dies ist eine sehr große Zahl, größer als, aber kleiner Width Single.MaxValue 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, der erheblich größer als die maximale Größe einer möglichen visuellen Anzeige ist, oder sie können diese Width nicht deterministische Obergrenze überschreiten.

Verwendung von XAML-Attributen

<object Width="double"/>  

- oder -

<object Width ="qualifiedDouble"/>  

- oder -

<object Width ="Auto"/>  

XAML-Werte

double
Double

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

qualifiedDouble
Ein double-Wert, wie oben beschrieben, gefolgt von einer der folgenden Zeichenfolgen für die Einheitendeklaration: px , , , in cm pt .

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

in ist Zoll; 1in==96px

cm ist Eindungs- 1cm==(96/2.54) px

pt ist Punkte; 1pt==(96/72) px

Auto
Aktiviert das Verhalten bei der automatischen Anpassung. Siehe Hinweise.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld WidthProperty
Metadateneigenschaften auf true festgelegt AffectsMeasure

Gilt für