FrameworkElement.Height FrameworkElement.Height FrameworkElement.Height FrameworkElement.Height Property

Definition

Ruft die vorgeschlagene Höhe des Elements ab oder legt sie fest.Gets or sets the suggested height of the element.

public:
 property double Height { 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 Height { get; set; }
member this.Height : double with get, set
Public Property Height As Double

Eigenschaftswert

Die Höhe des Elements in Geräteunabhängige Einheiten (1/96 Zoll pro Einheit)device-independent units (1/96th inch per unit).The height 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.

Hinweise

Heightist eine von drei beschreibbaren Eigenschaften FrameworkElement , die Höheninformationen angeben.Height is one of three writable properties on FrameworkElement that specify height information. Die anderen beiden sind MinHeight und MaxHeight.The other two are MinHeight and MaxHeight. Wenn ein Konflikt zwischen diesen Werten vorliegt, ist die Reihenfolge der Anwendung für die tatsächliche Höhenbestimmung, MinHeight dass zuerst berücksichtigt werden muss MaxHeight, und schließlich, wenn HeightSie sich innerhalb der Grenzen befindet.If there is a conflict between these values, the order of application for actual height determination is that first MinHeight must be honored, then MaxHeight, and finally, if it is within bounds, Height.

Wenn dieses Element ein untergeordnetes Element innerhalb eines anderen Elements ist, ist das Festlegen dieser Eigenschaft auf einen Wert wirklich nur ein empfohlener Wert.If this element is a child element within some other element, then setting this property to a value is really only a suggested value. Das Layoutsystem und die jeweilige Layoutlogik des übergeordneten Elements verwenden den Wert während des Layoutprozesses als nicht-Bindungs Eingabe.The layout system as well as the particular layout logic of the parent element will use the value as a nonbinding input during the layout process. Praktisch gesehen ist ein FrameworkElement fast immer das untergeordnete Element von etwas anderem, auch wenn Sie das Height on Windowfestlegen.In practical terms, a FrameworkElement is almost always the child element of something else; even when you set the Height on Window. (Für Windowwird dieser Wert verwendet, wenn das zugrunde liegende Anwendungsmodell die grundlegenden Renderingannahmen festlegt, die das HWND erstellen, das die Anwendung hostet.)(For Window, that value is used when the underlying application model establishes the basic rendering assumptions that create the Hwnd that hosts the application.)

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ößenanpassung im Code an.This is how you specify auto sizing behavior in code. Legen XAMLXAML 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 Höhe ablegt.Auto sizing behavior implies that the element will fill the height available to it. Beachten Sie jedoch, dass bestimmte Steuerelemente häufig Standardwerte über Ihre Standarddesign Stile 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 through their default theme styles that will disable the auto sizing behavior unless it is specifically re-enabled.

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 ActualHeight kann der Wert von variieren.In contrast, the value of the ActualHeight may vary. Dies kann entweder statisch vorkommen, weil das Layout die vorgeschlagene Größe aus irgendeinem Grund zurückgewiesen hat oder vorübergehend.This can happen either statically because the layout rejected the suggested size for some reason, or momentarily. Das Layoutsystem selbst arbeitet asynchron in Relation zum Satz des Height Eigenschaften Systems und hat diese spezielle Änderung der Größenänderung möglicherweise noch nicht verarbeitet.The layout system itself works asynchronously relative to the property system's set of Height and may not have processed that particular sizing property change yet.

Die Wert Einschränkungen für den Double Wert werden von einem ValidateValueCallback Mechanismus erzwungen.The value restrictions on the Double value are enforced by a ValidateValueCallback mechanism. Wenn Sie versuchen, einen ungültigen Wert festzulegen, wird eine Lauf Zeit Ausnahme ausgelöst.If you attempt to set an invalid value, a run-time exception is thrown.

Zusätzlich zur Überprüfungs Überprüfung gibt es einen nicht deterministischen oberen Wert Height , der vom Layoutsystem erzwungen wird (Dies ist eine sehr große Zahl, die größer als Single.MaxValue , aber kleiner als Double.MaxValueist).In addition to the validation check, there is a nondeterministic upper value bound for Height 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 Height 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 Height 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 Height="double"/>  

- oder --or-

<object Height="qualifiedDouble"/>  

- oder --or-

<object Height="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 1 Wert akzeptabel.For instance a value of 1 is acceptable.

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

px(Standard) istGerä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)

inist Zoll; 1In = = 96pxin is inches; 1in==96px

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

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

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

Informationen zur AbhängigkeitseigenschaftDependency Property Information

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

Gilt für:

Siehe auch