Version

Configuring the Drop-Down Size (xamComboEditor)

Topic Overview

Purpose

This topic explains how to Enable/Disable resizing of the xamComboEditor™ Drop-Down from the UI, as well as how to set the Drop-Down’s minimum and maximum widths and heights in code.

Required background

The following topic is a prerequisite to understanding this topic:

Topic Purpose

This topic describes how to get started with the xamComboEditor control and how to add it to your page using procedural code.

Drop-Down Resizing Configuration Summary

Drop-Down resizing configuration summary chart

The following table briefly explains the configurable aspects of the xamComboEditor Drop-Down resizing functionality and maps them to the properties that configure them. Further details are available after the table.

Configurable aspect Details Properties

Configures if the Drop-Down is resizable via a resize handle.

Configures the minimum width of the Drop-Down.

Configures the maximum width of the Drop-Down.

Configures the minimum height of the Drop-Down.

Configures the maximum height of the Drop-Down.

Enabling/Disabling Users to Resize the Drop-Down

Overview

The xamComboEditor Drop-Down is resizable in order to view all the items information using a resize handle.

The xamComboEditor Drop-Down resizing feature is enabled by default.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Enable/Disable the xamComboEditor drop-down resizing feature

bool

Example

The screenshot below demonstrates how the xamComboEditor would look as a result of the following settings:

Property Value

true

Manipulating the drop down size 1.png

Following is the code that implements this example.

In XAML:

<ig:XamComboEditor x:Name="ComboEditor"
                   DisplayMemberPath="ContactName"
                   AllowDropDownResizing="True" />

Configuring the Minimum Drop-Down Width

Overview

Specify the minimum Drop-Down width using the xamComboEditor MinDropDownWidth property.

The property’s default value is double.NaN.

If the MinDropDownWidth property’s value is not set, the minimum width of the Drop-Down is limited to the width of the xamComboEditor control text input field.

If the MinDropDownWidth value is greater than the MaxDropDownWidth value, the Drop-Down is no longer resizable horizontally and its width is fixed to the MinDropDownWidth value.

Note
Note

If a negative value is set to the MinDropDownWidth property, a System.ArgumentException is thrown.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Limit the minimum Drop-Down width during resizing

double

Example

The screenshot below demonstrates how the xamComboEditor Drop-Down behaves as a result of the following settings:

Property Value

150

Manipulating the drop down size 2.png

Following is the code that implements this example.

In XAML:

<ig:XamComboEditor x:Name="ComboEditor"
                   DisplayMemberPath="ContactName" MinDropDownWidth="150" />

Configuring the Maximum Drop-Down Width

Overview

Specify the maximum Drop-Down width using the xamComboEditor MaxDropDownWidth property.

The property’s default value is double.PositiveInfinity.

Note
Note

If a negative value is set to the MaxDropDownWidth property, a System.ArgumentException is thrown.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Limit the maximum Drop-Down width during resizing

double

Example

The screenshot below demonstrates how the xamComboEditor Drop-Down behaves as a result of the following settings:

Property Value

350

Manipulating the drop down size 3.png

Following is the code that implements this example.

In XAML:

<ig:XamComboEditor x:Name="ComboEditor"
                   DisplayMemberPath="ContactName" MaxDropDownWidth="350" />

Configuring the Minimum Drop-Down Height

Overview

Specify the minimum Drop-Down height using the xamComboEditor MinDropDownHeight property.

The property’s default value is 0.0.

If the MinDropDownHeight property’s value is not set, the minimum height of the Drop-Down is limited to 20px.

If the MinDropDownHeight value is greater than the MaxDropDownHeight value, the Drop-Down is no longer resizable vertically and its height is fixed to the MinDropDownHeight value.

Note
Note

If a negative value is set to the MinDropDownHeight property, a System.ArgumentException is thrown.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Limit the minimum Drop-Down height during resizing and filtering

double

Example

The screenshot below demonstrates how the xamComboEditor Drop-Down behaves as a result of the following settings:

Property Value

70

Manipulating the drop down size 5.png

Following is the code that implements this example.

In XAML:

<ig:XamComboEditor x:Name="ComboEditor" DisplayMemberPath="ContactName"
                   MinDropDownHeight="70" />

Configuring the Maximum Drop-Down Height

Overview

Specify the maximum Drop-Down height using the xamComboEditor MaxDropDownHeight property.

The property’s default value is double.PositiveInfinity.

Failure to set this property results in the available space above and below the control being estimated. The Drop-Down list is restricted within the available height of the application.

Note
Note

Setting the MaxDropDownHeight property to a negative value causes a System.ArgumentException to be thrown.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Limit the maximum Drop-Down height during resizing and filtering

double

Example

The screenshot below demonstrates how the xamComboEditor Drop-Down behaves as a result of the following settings:

Property Value

200

Manipulating the drop down size 4.png

Following is the code that implements this example.

In XAML:

<ig:XamComboEditor x:Name="ComboEditor"
                   DisplayMemberPath="ContactName"
                   MaxDropDownHeight="200" />

Related Topics

The following topics provide additional information related to this topic.

Topic Purpose

This topic describes the auto complete feature available in editable mode in the xamComboEditor .

This topic describes how to specify the xamComboEditor behavior when typing in the control’s text box.

This topic describes how to configure items filtering in the xamComboEditor control.

This topic describes how to use the xamComboEditor ItemTemplate property to customize the visualization of the items.

This topic describes selection in the xamComboEditor control.