FrameworkElement.Height Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows
Zestaw:
PresentationFramework.dll

Pobiera lub ustawia sugerowaną wysokość elementu.

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

Wartość właściwości

Double

Wysokość elementu w jednostkach niezależnych od urządzenia (1/96 cala na jednostkę). Wartość domyślna to NaN. Ta wartość musi być równa lub większa niż 0,0.

Atrybuty
TypeConverterAttribute LocalizabilityAttribute

Uwagi

Height jest jedną z trzech właściwości zapisywalnych, FrameworkElement które określają informacje o wysokości. Pozostałe dwa to MinHeight i MaxHeight. Jeśli występuje konflikt między tymi wartościami, kolejność stosowania rzeczywistej determinacji wysokości jest taka, że najpierw MinHeight musi być honorowana, a następnie MaxHeight, a na koniec, jeśli znajduje się w granicach, Height.

Jeśli ten element jest elementem podrzędnym w ramach innego elementu, ustawienie tej właściwości na wartość jest naprawdę tylko sugerowaną wartością. System układu, a także konkretna logika układu elementu nadrzędnego będzie używać wartości jako niebindujących danych wejściowych podczas procesu układu. W praktyce element jest FrameworkElement prawie zawsze elementem podrzędnym czegoś innego, nawet po ustawieniu Height elementu na Window. (W przypadku Windowparametru ta wartość jest używana, gdy bazowy model aplikacji ustanawia podstawowe założenia renderowania, które tworzą Hwnd hostujący aplikację).

Oprócz dopuszczalnych Double wartości ta właściwość może również mieć wartość Double.NaN. W ten sposób określasz zachowanie automatycznego określania rozmiaru w kodzie. W języku XAML ustawisz wartość na ciąg "Auto" (bez uwzględniania wielkości liter), aby włączyć zachowanie automatycznego określania rozmiaru. Zachowanie automatycznego określania rozmiaru oznacza, że element wypełni dostępną wysokość. Należy jednak pamiętać, że określone kontrolki często udostępniają wartości domyślne za pośrednictwem domyślnych stylów motywu, które wyłączą zachowanie automatycznego określania rozmiaru, chyba że zostaną one ponownie włączone.

Wartość zwracana tej właściwości jest zawsze taka sama jak każda ustawiona na nią wartość. Z kolei wartość ActualHeight elementu może się różnić. Może się to zdarzyć statycznie, ponieważ układ odrzucił sugerowany rozmiar z jakiegoś powodu lub chwilowo. Sam system układu działa asynchronicznie względem zestawu Height systemu właściwości i może jeszcze nie przetworzyć tej konkretnej zmiany rozmiaru właściwości.

Ograniczenia wartości dla Double wartości są wymuszane przez ValidateValueCallback mechanizm. Jeśli spróbujesz ustawić nieprawidłową wartość, zostanie zgłoszony wyjątek czasu wykonywania.

Oprócz sprawdzania poprawności istnieje niedeterministyczna górna granica, Height która jest wymuszana przez system układu (jest to bardzo duża liczba, większa niż Single.MaxValue ale mniejsza niż Double.MaxValue). Jeśli przekroczysz tę granicę, element nie zostanie renderowany i nie zostanie zgłoszony wyjątek. Nie należy ustawiać Height wartości, która jest znacznie większa niż maksymalny rozmiar dowolnej możliwej wizualizacji lub może przekroczyć tę niedeterministyczną górną granicę.

Użycie atrybutu języka XAML

<object Height="double"/>

-lub-

<object Height="qualifiedDouble"/>

-lub-

<object Height="Auto"/>

Wartości XAML

liczba o podwójnej precyzji
Double

Reprezentacja ciągu wartości równej Double lub większej niż 0,0. Zobacz uwagi, aby uzyskać informacje o górnej granicy. Ta wartość jest interpretowana jako miara niezależna od urządzenia (1/96 cala). Ciągi nie muszą jawnie uwzględniać punktów dziesiętnych. Na przykład wartość jest akceptowalna 1 .

qualifiedDouble
Podwójna wartość opisana powyżej, po której następuje jeden z następujących ciągów deklaracji jednostki: px, , cmin, pt.

px (ustawienie domyślne) to jednostki niezależne od urządzenia (1/96 cala na jednostkę)

in jest cala; 1in==96px

cm to centymetry; 1cm==(96/2.54) px

pt to punkty; 1pt==(96/72) px

Automatycznie
Włącza zachowanie automatycznego określania rozmiaru. Zobacz uwagi.

Informacje dotyczące właściwości zależności
Pole identyfikatora HeightProperty
Właściwości metadanych ustawione na true AffectsMeasure

Dotyczy

Zobacz też