FrameworkElement.Height Eigenschap

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

Waarde van eigenschap

De hoogte van het element, in apparaatonafhankelijke eenheden (1/96e inch per eenheid). De standaardwaarde is NaN. Deze waarde moet gelijk zijn aan of groter zijn dan 0,0.

Kenmerken

TypeConverterAttribute LocalizabilityAttribute

Opmerkingen

Height is een van de drie beschrijfbare eigenschappen waarop FrameworkElement hoogtegegevens worden opgegeven. De andere twee zijn MinHeight en MaxHeight. Als er een conflict is tussen deze waarden, is de volgorde van de toepassing voor de werkelijke hoogtebepaling dat eerst MinHeight moet worden gehonoreerd, en MaxHeightten slotte, en ten slotte, als deze binnen grenzen valt, Height.

Als dit element een onderliggend element binnen een ander element is, is het instellen van deze eigenschap op een waarde alleen een voorgestelde waarde. Het indelingssysteem en de specifieke indelingslogica van het bovenliggende element gebruiken de waarde als niet-bindende invoer tijdens het indelingsproces. In praktische termen is een FrameworkElement bijna altijd het onderliggende element van iets anders, zelfs als je het Height op Windowinstelt. (Voor Windowdeze waarde wordt deze waarde gebruikt wanneer het onderliggende toepassingsmodel de basisweergaveveronderstellingen vastlegt die de Hwnd maken die als host fungeert voor de toepassing.)

Naast acceptabele Double waarden kan deze eigenschap ook zijn Double.NaN. Op deze wijze geeft u het gedrag voor automatische grootte in code op. In XAML stelt u de waarde in op de tekenreeks 'Auto' (hoofdlettergevoelig) om het gedrag van de automatische grootte in te schakelen. Automatisch formaatgedrag impliceert dat het element de hoogte vult die beschikbaar is voor het element. Houd er echter rekening mee dat specifieke besturingselementen vaak standaardwaarden leveren via hun standaardthemastijlen waarmee het gedrag voor automatisch aanpassen wordt uitgeschakeld, tenzij deze specifiek opnieuw is ingeschakeld.

De retourwaarde van deze eigenschap is altijd hetzelfde als elke waarde die erop is ingesteld. De waarde van de ActualHeight waarde kan daarentegen variëren. Dit kan statisch gebeuren omdat de indeling de voorgestelde grootte om een of andere reden heeft afgewezen, of tijdelijk. Het indelingssysteem zelf werkt asynchroon ten opzichte van Height de set van het eigenschappensysteem en heeft mogelijk nog niet verwerkt dat bepaalde wijziging van de grootte van de eigenschap.

De waardebeperkingen voor de Double waarde worden afgedwongen door een ValidateValueCallback mechanisme. Als u een ongeldige waarde probeert in te stellen, wordt er een runtime-uitzondering gegenereerd.

Naast de validatiecontrole is er een niet-deterministische bovenwaarde die Height wordt afgedwongen door het indelingssysteem (dit is een zeer groot getal, groter dan Single.MaxValue maar kleiner dan Double.MaxValue). Als u deze limiet overschrijdt, wordt het element niet weergegeven en wordt er geen uitzondering gegenereerd. Stel niet in Height op een waarde die aanzienlijk groter is dan de maximale grootte van een mogelijke visuele weergave, of u kunt deze niet-deterministische bovengrens overschrijden.

XAML-kenmerkgebruik

<object Height="double"/>

– of –

<object Height="qualifiedDouble"/>

– of –

<object Height="Auto"/>

XAML-waarden

DubbeleDouble

Tekenreeksweergave van een Double waarde die gelijk is aan of groter is dan 0,0. Zie Opmerkingen voor informatie over de bovengrens. Deze waarde wordt geïnterpreteerd als een apparaatonafhankelijke eenheid (1/96e inch) meting. Tekenreeksen hoeven niet expliciet decimale punten op te nemen. Een waarde is 1 bijvoorbeeld acceptabel.

qualifiedDouble Een dubbele waarde zoals hierboven beschreven, gevolgd door een van de volgende eenheidsdeclaratietekenreeksen: px, in, cm, , . pt

px (standaard) is apparaatonafhankelijke eenheden (1/96e inch per eenheid)

in is inches; 1in==96px

cm is centimeters; 1cm==(96/2,54) px

pt is punten; 1pt==(96/72) px

Auto Hiermee schakelt u automatisch aanpassen van gedrag in. Zie opmerkingen.

Informatie over afhankelijkheidseigenschappen

Zie ook

• ActualHeight