FrameworkElement.Height Eigenschaft

public:
 property double Height { double get(); void set(double value); };

double Height();

void Height(double value);

public double Height { get; set; }

var double = frameworkElement.height;
frameworkElement.height = double;

Public Property Height As Double

<frameworkElement Height="double"/>
-or-
<frameworkElement Height="Auto"/>
 

Eigenschaftswert

Die Höhe des Objekts in Pixel. Der Standardwert ist NaN. Mit Ausnahme des speziellen NaN-Werts muss dieser Wert gleich oder größer als 0 sein.

Beispiele

Dieses Beispiel zeigt einen einfachen Eigenschaftensatz eines UI-Elements, das zur Laufzeit erstellt wird und die Initialisierung des Inhalts und grundlegende Anzeigeeigenschaften wie HeightBreite und Hintergrund benötigt. (Der Hintergrund ist tatsächlich eine Control-Eigenschaft , nicht durch FrameworkElement definiert.)

Button button2 = new Button();
button2.Height = 50;
button2.Width = 100;
button2.Background = new SolidColorBrush(Colors.Blue);
button2.Content = "Click Me";

Hinweise

Height ist eine von drei beschreibbaren Eigenschaften für FrameworkElement , die 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

Mehrere der abgeleiteten FrameworkElement-Typen werden auch von Shape abgeleitet. Nicht alle Shape Klassen verwenden Height oder Width , um deren Darstellung anzugeben, und verwenden sie stattdessen bestimmte Eigenschaften, die einen Satz von Punkten definieren können. In diesem Fall wird eine Height oder Width eine Berechnung vorgenommen, wird jedoch in der Regel nicht direkt festgelegt.

Benutzerdefinierte Klassen weisen möglicherweise ähnliche Überlegungen auf, bei denen die Klasse möglicherweise Eigenschaften aufweist, die für die Angabe von Dimensionen aussagekräftiger sind als dies oder HeightDie Breite. Height oder Width sind beide weiterhin als Mitglieder verfügbar und können festgelegt werden.

Das Objekt, bei dem die Height Eigenschaften oder Width-Eigenschaften festgelegt werden, ist fast immer ein untergeordnetes Objekt in der untergeordneten Auflistung eines anderen übergeordneten Elements, und das Festlegen Height oder Width Auf einen Wert ist nur ein vorgeschlagener Wert für den Layoutprozess. Das Layoutsystem sowie die spezielle Layoutlogik der Klasse des übergeordneten Elements verwenden den Wert während des Layoutprozesses als nicht gebundene Eingabe und müssen möglicherweise das Objekt ausschneiden, die Größe des Objekts ändern, die Größe des Containers ändern oder eine Kombination dieser Verhaltensweisen umfassen, die mehrere teilnehmende Objekte im Layout umfassen. Rand und Abstand wirken sich auch auf die verfügbare Größe aus. Weitere Informationen finden Sie unter Ausrichtung, Rand und Abstand.

Der Rückgabewert dieser Eigenschaft ist immer identisch mit jedem Wert, der darauf festgelegt wurde. Im Gegensatz dazu kann der Wert der ActualHeight-Eigenschaft variieren. Die Varianz kann entweder statisch auftreten, da das Layout die vorgeschlagene Größe abgelehnt hat, oder im Moment. Das Layoutsystem selbst funktioniert asynchron relativ zum Satz von Höhe des Eigenschaftensystems, und das Layoutsystem hat möglicherweise noch keine Änderung der Größenänderung der Eigenschaft verarbeitet.

Negative Werte sind Height unzulässig.

Legen Sie außerdem keinen Height Wert fest, der wesentlich größer als die maximale Größe einer möglichen visuellen Anzeige ist.

"Auto" und NaN

Der Standardwert und Heightdie Breite ist "Auto", dargestellt durch NaN. Im XAML-Markup können Sie die Zeichenfolge "Auto" verwenden, um den Wert auf NaN festzulegen.

Weitere Informationen

• Width
• ActualHeight
• MinHeight
• MaxHeight
• Definieren von Layouts mit XAML
• Ausrichtung, Rand und Abstand