FrameworkElement.Height Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Ruft die vorgeschlagene Höhe des Elements ab oder legt sie fest.

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

Double

Die Höhe des Elements in geräteunabhängigen Einheiten (1/96 Zoll pro Einheit). Der Standardwert ist NaN. Dieser Wert muss größer oder gleich 0,0 sein.

Attribute

TypeConverterAttribute LocalizabilityAttribute

Hinweise

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

Wenn es sich bei diesem Element um ein untergeordnetes Element innerhalb eines anderen Elements handelt, ist das Festlegen dieser Eigenschaft auf einen Wert wirklich nur ein vorgeschlagener Wert. Sowohl das Layoutsystem als auch die spezielle Layoutlogik des übergeordneten Elements verwenden den Wert während des Layoutprozesses als nicht bindende Eingabe. In der Praxis ist ein FrameworkElement fast immer das untergeordnete Element eines anderen Elements, auch wenn Sie auf HeightWindowfestlegen. (Für Windowwird dieser Wert verwendet, wenn das zugrunde liegende Anwendungsmodell die grundlegenden Renderingannahmen festlegt, die den Hwnd erstellen, der die Anwendung hostet.)

Zusätzlich zu zulässigen Double Werten kann diese Eigenschaft auch sein Double.NaN. Auf diese Weise geben Sie das Verhalten für die automatische Größenanpassung im Code an. In XAML legen Sie den Wert auf die Zeichenfolge "Auto" (ohne Berücksichtigung der Groß-/Kleinschreibung) fest, um das Verhalten der automatischen Größenanpassung zu aktivieren. Das Automatische Größenanpassungsverhalten impliziert, dass das Element die höhe ausfüllt, die es zur Verfügung hat. Beachten Sie jedoch, dass bestimmte Steuerelemente häufig Standardwerte über ihre Standarddesignstile bereitstellen, die das Verhalten der automatischen Größenanpassung deaktivieren, es sei denn, es wird ausdrücklich wieder aktiviert.

Der Rückgabewert dieser Eigenschaft ist immer identisch mit jedem Wert, der darauf festgelegt wurde. Im Gegensatz dazu kann der Wert des ActualHeight variieren. Dies kann entweder statisch geschehen, weil das Layout die vorgeschlagene Größe aus irgendeinem Grund abgelehnt hat, oder vorübergehend. Das Layoutsystem selbst arbeitet asynchron relativ zum Satz von Height eigenschaftensystem und hat diese bestimmte Größeneigenschaftsä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üfung gibt es eine nicht deterministische Oberwertgrenze für Height , die 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 nicht auf einen Wert fest Height , der erheblich 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

double
Double

Zeichenfolgendarstellung eines Double Werts gleich oder größer 0,0. Informationen zur Obergrenze finden Sie unter „Hinweise“. Dieser Wert wird als geräteunabhängige Einheitsmessung (1/96 Zoll) interpretiert. Zeichenfolgen müssen nicht explizit Dezimalstellen enthalten. Für instance ist ein Wert von 1 akzeptabel.

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 Verhalten. Siehe Hinweise.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	HeightProperty
Metadateneigenschaften auf true festgelegt	AffectsMeasure

Weitere Informationen

• ActualHeight