Edit

Share via


FrameworkElement.MaxHeight Property

Definition

Gets or sets the maximum height constraint of the element.

public:
 property double MaxHeight { 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 MaxHeight { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.MaxHeight : double with get, set
Public Property MaxHeight As Double

Property Value

The maximum height of the element, in device-independent units (1/96th inch per unit). The default value is PositiveInfinity. This value can be any value equal to or greater than 0.0. PositiveInfinity is also valid.

Attributes

Remarks

This is one of three properties on FrameworkElement that specify height information. The other two are MinHeight and Height. If there is a conflict between these values, the order of application for actual height determination is first MinHeight must be honored, then MaxHeight, and finally if each of these are within bounds, Height.

The value restrictions on the Double value are enforced by a ValidateValueCallback mechanism. If you attempt to set an invalid value a run-time exception is thrown.

XAML Attribute Usage

<object MaxHeight="double"/>

-or-

<object MaxHeight ="qualifiedDouble"/>

XAML Values

double Double

String representation of a Double value equal to or greater than 0.0. This is interpreted as a device-independent unit (1/96th inch) measurement. Strings need not explicitly include decimal points. For instance a value of 1 is acceptable.

The same Double range restrictions as mentioned in the Property Value section apply, except that you must use x:Static Markup Extension if you need to explicitly set the value to be PositiveInfinity.

qualifiedDouble A double value as described above, followed by one of the following unit declaration strings: px, in, cm, pt.

px (default) is device-independent units (1/96th inch per unit)

in is inches; 1in==96px

cm is centimeters; 1cm==(96/2.54) px

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

Dependency Property Information

Item Value
Identifier field MaxHeightProperty
Metadata properties set to true AffectsMeasure

Applies to