FrameworkElement.Height Eigenschaft

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

[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Height : double with get, set

Public Property Height As Double

Eigenschaftswert

Die Höhe 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.

Attribute

TypeConverterAttribute LocalizabilityAttribute

Hinweise

Height ist eine von drei beschreibbaren Eigenschaften, die FrameworkElement Höheninformationen angeben. Die anderen beiden sind MinHeight und MaxHeight. Wenn ein Konflikt zwischen diesen Werten besteht, besteht die Reihenfolge der Anwendung für die tatsächliche Höhesbestimmung darin, dass zuerst MinHeight berücksichtigt werden muss, und MaxHeightschließlich, wenn sie sich innerhalb der Grenzen befindet. Height

Wenn es sich bei diesem Element um ein untergeordnetes Element innerhalb eines anderen Elements handelt, ist das Festlegen dieser Eigenschaft auf einen Wert tatsächlich nur ein vorgeschlagener Wert. Das Layoutsystem sowie die spezielle Layoutlogik des übergeordneten Elements verwenden den Wert während des Layoutprozesses als nicht gebundene Eingabe. In der Praxis ist eine FrameworkElement fast immer das untergeordnete Element eines anderen Elements; auch wenn Sie die Height Einstellung Windowfestlegen. (Bei Windowdiesem Wert wird dieser Wert verwendet, wenn das zugrunde liegende Anwendungsmodell die grundlegenden Renderingannahmen festlegt, die den Hwnd erstellen, der die Anwendung hostet.)

Zusätzlich zu akzeptablen Double Werten kann diese Eigenschaft auch sein Double.NaN. So geben Sie das Verhalten der automatischen Größenanpassung im Code 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 bedeutet, dass das Element die verfügbare Höhe ausfüllt. Beachten Sie jedoch, dass bestimmte Steuerelemente häufig Standardwerte über ihre Standarddesignstile bereitstellen, mit denen das Verhalten der automatischen Größenanpassung deaktiviert wird, es sei denn, sie ist ausdrücklich erneut aktiviert.

Der Rückgabewert dieser Eigenschaft ist immer identisch mit jedem Wert, der darauf festgelegt wurde. Im Gegensatz dazu kann der Wert des Werts ActualHeight variieren. Dies kann entweder statisch geschehen, da das Layout die vorgeschlagene Größe aus irgendeinem Grund abgelehnt hat oder momentan. Das Layoutsystem selbst funktioniert asynchron relativ zum Satz des Height Eigenschaftensystems und hat diese bestimmte Größenänderung möglicherweise noch nicht verarbeitet.

Die Werteinschränkungen für den Double Wert werden durch einen ValidateValueCallback Mechanismus erzwungen. Wenn Sie versuchen, einen ungültigen Wert festzulegen, wird eine Laufzeit ausnahme ausgelöst.

Zusätzlich zur Überprüfungsprüfung gibt es einen nicht deterministischen oberen Wert, der Height 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 Height 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 Height="double"/>

-oder-

<object Height="qualifiedDouble"/>

-oder-

<object Height="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

Weitere Informationen

• ActualHeight