FrameworkElement.Height Egenskap

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

Egenskapsvärde

Elementets höjd i enhetsoberoende enheter (1/96 tum per enhet). Standardvärdet är NaN. Det här värdet måste vara lika med eller större än 0,0.

Attribut

TypeConverterAttribute LocalizabilityAttribute

Kommentarer

Height är en av tre skrivbara egenskaper som FrameworkElement anger höjdinformation. De andra två är MinHeight och MaxHeight. Om det finns en konflikt mellan dessa värden är ordningen för programmet för faktisk höjdbestämning att först MinHeight måste respekteras, sedan MaxHeight, och slutligen, om det är inom gränser, Height.

Om det här elementet är ett underordnat element i något annat element är det egentligen bara ett föreslaget värde att ange den här egenskapen till ett värde. Layoutsystemet samt den specifika layoutlogik för det överordnade elementet använder värdet som indata som inte ärbindande under layoutprocessen. I praktiken är en FrameworkElement nästan alltid det underordnade elementet i något annat; även när du ställer in på HeightWindow. (För Windowanvänds det värdet när den underliggande programmodellen upprättar de grundläggande renderingsantagandena som skapar den Hwnd som är värd för programmet.)

Förutom acceptabla Double värden kan den här egenskapen också vara Double.NaN. Så här anger du beteende för automatisk storleksändring i kod. I XAML anger du värdet till strängen "Auto" (skiftlägesokänslig) för att aktivera funktionen för automatisk storleksändring. Beteende för automatisk storleksändring innebär att elementet fyller den tillgängliga höjden. Observera dock att specifika kontroller ofta tillhandahåller standardvärden via deras standardtemaformat som inaktiverar beteendet för automatisk storleksändring om det inte är specifikt återaktiverat.

Returvärdet för den här egenskapen är alltid detsamma som alla värden som har angetts till den. Däremot kan värdet för kan ActualHeight variera. Detta kan inträffa statiskt eftersom layouten avvisade den föreslagna storleken av någon anledning eller tillfälligt. Själva layoutsystemet fungerar asynkront i förhållande till egenskapssystemets uppsättning och Height kanske inte har bearbetat den specifika storleksegenskapsändringen ännu.

Värdebegränsningarna för Double värdet framtvingas av en ValidateValueCallback mekanism. Om du försöker ange ett ogiltigt värde genereras ett körningsfel.

Förutom verifieringskontrollen finns det ett icke-förutbestämt övre värde som är bundet till Height som tillämpas av layoutsystemet (det här är ett mycket stort tal, större än Single.MaxValue men mindre än Double.MaxValue). Om du överskrider den här gränsen renderas inte elementet och inget undantag genereras. Ange inte Height till ett värde som är betydligt större än den maximala storleken för en eventuell visuell visning, eller så kan du överskrida denna icke-terministiska övre gräns.

XAML-attributanvändning

<object Height="double"/>

-eller-

<object Height="qualifiedDouble"/>

-eller-

<object Height="Auto"/>

XAML-värden

DubbelDouble

Strängrepresentation av ett Double värde som är lika med eller större än 0,0. Se Kommentarer för information med övre gräns. Det här värdet tolkas som en enhetsoberoende enhet (1/96 tum) mätning. Strängar behöver inte uttryckligen innehålla decimaltecken. Till exempel är ett värde av 1 acceptabelt.

qualifiedDouble Ett dubbelt värde enligt beskrivningen ovan, följt av någon av följande enhetsdeklarationssträngar: px, in, cm, . pt

px (standard) är enhetsoberoende enheter (1/96 tum per enhet)

in är tum; 1in==96px

cm är centimeter; 1cm==(96/2.54) px

pt är punkter; 1pt==(96/72) px

Auto Aktiverar beteende för automatisk storleksändring. Se Kommentarer.

Information om beroendeegenskap

Se även

• ActualHeight