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; }
[<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

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). Standardwert: NaN.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

Dabei handelt es sich um eine von drei Eigenschaften FrameworkElement , die Informationen zur Breite 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, muss zunächst die Reihenfolge der Anwendung für die tatsächliche breiten Bestimmung berücksichtigt MinWidth werden, dann MaxWidth und 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 von 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 von 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 sein Double.NaN .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. XAMLXAMLLegen Sie den Wert in der Zeichenfolge "Auto" (ohne Beachtung der Groß-/Kleinschreibung) fest, um das Verhalten der automatischen 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 Width vom Layoutsystem erzwungen wird (Dies ist eine sehr große Zahl, die größer als, Single.MaxValue aber kleiner als ist 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). 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 keinen Wert fest, der Width 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, der gleich oder größer als 0,0 ist.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) Maßeinheit 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: