FrameworkElement.Width Eigenschaft

Definition

Ruft die Breite des Elements ab oder legt sie 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

Die Breite des Elements in geräteunabhängigen Einheiten (1/96. Zoll pro Einheit). Der Standardwert ist NaN. Dieser Wert muss gleich oder größer als 0,0 sein. Informationen zu oberen Begrenzungen finden Sie in den Hinweisen.

Attribute

Hinweise

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

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

Zusätzlich zu 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" (Groß-/Kleinschreibung wird nicht beachtet) 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 Standardstilen bereitstellen, die das Verhalten der automatischen Größenanpassung deaktivieren, es sei denn, sie ist ausdrücklich erneut aktiviert.

Zusätzlich zur Überprüfungsprüfung gibt es einen nicht deterministischen oberen Wert, der 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 keinen Width Wert fest, der wesentlich größer als die maximale Größe einer möglichen visuellen Anzeige ist, oder Sie können diese nicht deterministische Obergrenze überschreiten.

Verwendung von XAML-Attributen

<object Width="double"/>

-oder-

<object Width ="qualifiedDouble"/>

-oder-

<object Width ="Auto"/>

XAML-Werte

DoppelDouble

Zeichenfolgendarstellung eines Double Werts gleich oder größer als 0,0. Informationen zu oberen Begrenzungen finden Sie in den Hinweisen. Dieser Wert wird als geräteunabhängige Einheit (1/96. Zoll) interpretiert. Zeichenfolgen müssen keine dezimalen Punkte enthalten. Beispielsweise ist ein Wert zulässig 1 .

qualifiedDouble Ein doppelter 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 ist Punkte; 1pt==(96/72) px

Auto Aktiviert das Automatische Skalieren. Siehe Anmerkungen.

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld WidthProperty
Auf Metadateneigenschaften festgelegt true AffectsMeasure

Gilt für: