ComboBox.MaxDropDownHeight Property

Reference

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the maximum height for a combo box drop-down.

public:
 property double MaxDropDownHeight { double get(); void set(double value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
public double MaxDropDownHeight { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
member this.MaxDropDownHeight : double with get, set

Public Property MaxDropDownHeight As Double

Property Value

Double

A double that represents the height that is retrieved or the height to set. The default value as defined to the property system is a calculated value based on taking a one-third fraction of the system max screen height parameters, but this default is potentially overridden by various control templates.

Attributes: BindableAttribute TypeConverterAttribute

Examples

The following example shows how to use the MaxDropDownHeight property to specify the height of the ComboBox control's drop-down.

<Setter Property = "MaxDropDownHeight" Value="30"/>

Remarks

Auto sizing is not the default, and will result in the drop down size potentially exceeding the available size in the parent element. This is not typically desirable.

Dependency Property Information

Item	Value
Identifier field	MaxDropDownHeightProperty
Metadata properties set to `true`	None

XAML Attribute Usage

<object MaxDropDownHeight="double"/>
- or -
<object MaxDropDownHeight ="qualifiedDouble"/>
- or -
<object MaxDropDownHeight ="Auto"/>

XAML Values

double Double

String representation of a Double value. 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.

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

Auto Enables autosizing behavior. See Remarks.

Applies to

Jaa