FrameworkElement.Width Eigenschaft

Definition

Ruft die Breite des Elements ab bzw. legt diese fest.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

Eigenschaftswert

Ruft die Breite des Elements in Geräteunabhängige Einheiten (1/96 Zoll pro Einheit)device-independent units (1/96th inch per unit) ab.The width of the element, in Geräteunabhängige Einheiten (1/96 Zoll pro Einheit)device-independent units (1/96th inch per unit). Der Standardwert ist NaNsein.The default value is NaN. Dieser Wert muss größer oder gleich 0,0 sein.This value must be equal to or greater than 0.0. Informationen zur Obergrenze finden Sie unter „Hinweise“.See Remarks for upper bound information.

Attribute

Hinweise

Dies ist eine von drei Eigenschaften in FrameworkElement, die breiten Informationen angeben.This is one of three properties on FrameworkElement that specify width information. Die anderen beiden sind MinWidth und MaxWidth.The other two are MinWidth and MaxWidth. Wenn ein Konflikt zwischen diesen Werten vorliegt, wird zuerst die Reihenfolge der Anwendung für die tatsächliche Breite bestimmt MinWidth muss berücksichtigt werden, dann MaxWidthund schließlich, wenn sich diese innerhalb der Grenzen befinden, Width.If 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.

Der Rückgabewert dieser Eigenschaft ist immer identisch mit dem Wert, der auf den Wert festgelegt wurde.The return value of this property is always the same as any value that was set to it. Im Gegensatz dazu kann der Wert des ActualWidth variieren.In contrast, the value of the ActualWidth may vary. Das Layout hat möglicherweise die vorgeschlagene Größe aus irgendeinem Grund abgelehnt.The layout may have rejected the suggested size for some reason. Außerdem arbeitet das Layoutsystem selbst asynchron in Relation zum Eigenschaften System Satz Width und hat diese spezielle Änderung der Größenänderung möglicherweise noch nicht verarbeitet.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.

Zusätzlich zu zulässigen Double Werten kann diese Eigenschaft auch Double.NaNwerden.In addition to acceptable Double values, this property can also be Double.NaN. Auf diese Weise geben Sie das Verhalten für die automatische Größenänderung an.This is how you specify auto sizing behavior. In XAMLXAML Sie den Wert auf die Zeichenfolge "Auto" (ohne Beachtung der Groß-/Kleinschreibung) festlegen, um das Verhalten für die automatische GrößenanpassungIn XAMLXAML you set the value to the string "Auto" (case insensitive) to enable the auto sizing behavior. Das Verhalten der automatischen Größenanpassung impliziert, dass das Element die verfügbare Breite ablegt.Auto sizing behavior implies that the element will fill the width available to it. Beachten Sie jedoch, dass bestimmte Steuerelemente häufig Standardwerte in ihren Standardformaten bereitstellen, die das Verhalten der automatischen Größenänderung deaktivieren, es sei denn, es wird ausdrücklich erneut aktiviert.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.

Zusätzlich zur Überprüfungs Überprüfung gibt es einen nicht deterministischen oberen Wert, der für Width gebunden ist, der vom Layoutsystem erzwungen wird (Dies ist eine sehr hohe Zahl, die größer als Single.MaxValue, aber kleiner als Double.MaxValue) ist.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). Wenn diese Grenze überschritten wird, wird das Element nicht mehr angezeigt, und es wird keine Ausnahme ausgelöst.If you exceed this bound, the element will not render, and no exception is thrown. Legen Sie Width nicht auf einen Wert fest, der deutlich größer als die maximale Größe einer möglichen visuellen Darstellung ist, oder diese nicht deterministische obere Grenze überschreiten.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.

Verwendung von XAML-AttributenXAML Attribute Usage

<object Width="double"/>  

- oder --or-

<object Width ="qualifiedDouble"/>  

- oder --or-

<object Width ="Auto"/>  

XAML-WerteXAML Values

doubledouble
Double

Zeichen folgen Darstellung eines Double Werts gleich oder größer als 0,0.String representation of a Double value equal to or greater than 0.0. Informationen zur Obergrenze finden Sie unter „Hinweise“.See Remarks for upper bound information. Dieser Wert wird als Geräteunabhängige Einheit (1/96 Zoll)device-independent unit (1/96th inch) Messung interpretiert.This value is interpreted as a Geräteunabhängige Einheit (1/96 Zoll)device-independent unit (1/96th inch) measurement. Zeichen folgen müssen nicht explizit Dezimalstellen enthalten.Strings need not explicitly include decimal points. Beispielsweise ist der Wert 1 akzeptabel.For instance a value of 1 is acceptable.

qualifiedDoublequalifiedDouble
Ein doppelter Wert, wie oben beschrieben, gefolgt von einer der folgenden Einheiten Deklarations Zeichenfolgen: px, in, cm, pt.A double value as described above, followed by one of the following unit declaration strings: px, in, cm, pt.

px (Standard) ist Geräteunabhängige Einheiten (1/96 Zoll pro Einheit)device-independent units (1/96th inch per unit)px (default) is Geräteunabhängige Einheiten (1/96 Zoll pro Einheit)device-independent units (1/96th inch per unit)

in ist Zoll. 1In = = 96pxin is inches; 1in==96px

cm ist Zentimeter. 1cm = = (96/2,54) pxcm is centimeters; 1cm==(96/2.54) px

pt ist Punkte. 1pt = = (96/72) pxpt is points; 1pt==(96/72) px

Auto
Aktiviert das Verhalten der automatische Größenanpassung.Enables autosizing behavior. Siehe Hinweise.See Remarks.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field WidthProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true AffectsMeasure

Gilt für: