Table of Contents

Class TextBoxWithListPopup

Namespace
Alternet.UI
Assembly
Alternet.UI.Common.dll

Represents a TextBox with a combo button that, when clicked, displays a popup window containing a VirtualListBox.

public class TextBoxWithListPopup : TextBoxAndButton, IBaseObjectWithAttr, IBaseObjectWithId, INotifyPropertyChanged, IDisposableObject, IBaseObject, ISupportInitialize, IFocusable, ITextProperty, IComponent, IControl, IDisposable, IWin32Window, ILayoutItem, INotifyDataErrorInfo
Inheritance
TextBoxWithListPopup
Implements
Derived

Constructors

TextBoxWithListPopup()

Initializes a new instance of the TextBoxWithListPopup class.

Properties

ButtonCombo

Gets combo button if it is available.

DroppedDown

Gets a value indicating whether the combo box is displaying its drop-down portion.

EmptyTextHint

Gets or sets a hint shown in an empty unfocused text control.

Items

Gets the collection of items used in the list box control within the popup window.

ListBox

Gets the list box control used in the popup window.

LookupByValue

Gets or sets a value indicating whether to perform lookup by value when popup window is opened.

LookupExactText

Gets or sets a value indicating whether to perform an exact text lookup when popup window is opened.

LookupIgnoreCase

Gets or sets a value indicating whether to ignore case when looking up items in the popup window.

SimpleItems

Gets simple items where item is object. It is mapped from Value elements of the Items collection.

TextSelectionLength

Gets the number of characters selected in the editable portion of the combo box.

TextSelectionStart

Gets the starting index of text selected in the combo box.

UseContextMenuAsPopup

Gets or sets a value indicating whether to use a context menu as the popup window.

Methods

AddRange(IEnumerable)

Adds a collection of items to the control.

GetBtnComboType()

Gets type of the SpeedButton ancestor class used as combo box button.

HidePopup(ModalResult)

Hides the popup window associated with the control and sets the result of the popup window operation.

OnButtonComboBeforeShowPopup(object?, EventArgs)

Handles the event triggered before the popup is displayed for the button combo.

OnButtonComboValueChanged(object?, EventArgs)

Handles the event triggered when the data value of the button combo changes.

OnDropDown(EventArgs)

Called when the DropDown event is fired.

OnDropDownClosed(EventArgs)

Called when the DropDownClosed event is fired.

OnMouseLeftButtonDown(MouseEventArgs)

Called when the left mouse button was pressed.

OnSubstituteControlMouseLeftButtonDown(object, MouseEventArgs)

Called when mouse left button is pressed on the substitute control.

RaiseDropDown()

Raises the DropDown event and calls OnDropDown(EventArgs) method.

RaiseDropDownClosed()

Raises the DropDownClosed event and calls OnDropDownClosed(EventArgs) method.

ShowPopup()

Shows the popup window associated with the control.

SyncTextAndComboButton()

Synchronizes text property of the main control and value selected in the popup window which is shown when combo button is clicked.

UpdateSubstituteControlText()

Updates the text of the substitute control to match the text of the main control.

Events

DropDown

Occurs when the drop-down portion of the control is shown.

DropDownClosed

Occurs when the drop-down portion of the control is no longer visible.