FrameworkElement.Height Właściwość

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

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 między tymi wartościami występuje konflikt, kolejność stosowania rzeczywistej determinacji wysokości polega na tym, że najpierw MinHeight musi zostać uznane, 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 danych wejściowych niezwiązanych podczas procesu układu. W praktyce element jest FrameworkElement prawie zawsze elementem podrzędnym czegoś innego, nawet jeśli ustawisz Height wartość na .Window (W przypadku Windowprogramu ta wartość jest używana, gdy bazowy model aplikacji ustanawia podstawowe założenia renderowania, które tworzą element Hwnd hostujący aplikację).

Oprócz dopuszczalnych Double wartości ta właściwość może również mieć Double.NaNwartość . 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 pomocą domyślnych stylów motywu, które spowodują wyłączenie zachowania automatycznego określania rozmiaru, chyba że zostanie ona ponownie włączona.

Wartość zwracana tej właściwości jest zawsze taka sama jak każda wartość ustawiona na tę właściwość. 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 Double dotyczące 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 wartości, która jest wymuszana przez system układu (jest to bardzo duża liczba, większa niż ale mniejsza niż Single.MaxValueDouble.MaxValue). Jeśli przekroczysz tę granicę, element nie będzie renderowany i nie zostanie zgłoszony żaden wyjątek. Nie należy ustawiać Height wartości, która jest znacznie większa niż maksymalny rozmiar dowolnego możliwego wyświetlania wizualizacji lub może przekroczyć tę niedeterministyczną górną granicę.

Użycie atrybutu XAML

<object Height="double"/>

— lub —

<object Height="qualifiedDouble"/>

— lub —

<object Height="Auto"/>

Wartości XAML

PodwójneDouble

Reprezentacja Double ciągu wartości równej lub większej niż 0,0. Zobacz Uwagi, aby uzyskać informacje o górnej granicy. Ta wartość jest interpretowana jako jednostka 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 .

qualifiedDoublePodwójna wartość, jak opisano powyżej, a następnie jeden z następujących ciągów deklaracji jednostki: px, , incm, 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 autoskalowania. Zobacz uwagi.

Informacje o właściwości zależności

Zobacz też

• ActualHeight