RepositoryItemLookUpEditBase.PopupWidthMode Property

Gets or sets whether the initial popup width matches the editor or content width.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v24.2.dll

Declaration

C#

[DefaultValue(PopupWidthMode.Default)]
[DXCategory("Behavior")]
public PopupWidthMode PopupWidthMode { get; set; }

VB.NET

<DXCategory("Behavior")>
<DefaultValue(PopupWidthMode.Default)>
Public Property PopupWidthMode As PopupWidthMode

Property Value

Type	Default	Description
DevExpress.XtraEditors.PopupWidthMode	Default	A DevExpress.XtraEditors.PopupWidthMode enumeration value, such as ContentWidth or UseEditorWidth, that specifies whether the initial popup width matches the editor or content width.

Remarks

Since version 17.2, the initial popup width matches the editor width by default (when PopupWidthMode is set to Default). By setting the WindowsFormsSettings.DefaultSettingsCompatibilityMode global setting to v17_1 or earlier, you can override the default behavior for your version, and enable the popup width to match the content width by default.

Note

The popup width matches the content width by default, regardless of the version of DevExpress components is installed if:

• the RepositoryItemLookUpEditBase.BestFitMode option is enabled,
• the RepositoryItemPopupBase.PopupFormSize (RepositoryItemLookUpEdit.PopupWidth for LookUpEdit) setting is set to any custom value.

The PopupWidthMode property allows you to override the default behavior for the current editor. Set the PopupWidthMode property to PopupWidthMode.ContentWidth or PopupWidthMode.UseEditorWidth to make the initial width of the popup match the popup content (left screenshot) or editor width (right screenshot), respectively:

Note

If the editor width is less than the minimum popup width specified with the RepositoryItemPopupBase.PopupFormMinSize setting (or the default minimum popup width), the popup width follows this setting regardless the PopupWidthMode property.