Table of Contents

TTMSFNCSearchEdit Class

Combines a text edit, a category button, and a search button with a filterable drop-down list.

API unit family: TMSFNCSearchEdit Inherits from: TTMSFNCCustomControl Implements: ITMSFNCStylesManager

Syntax

TTMSFNCSearchEdit = class(TTMSFNCCustomControl, ITMSFNCStylesManager)

Properties

Name Description
Appearance Gets or sets the visual appearance settings for the search list.
AutoDropDown When True, the drop-down list opens automatically as the user types.
AutoSelect When True, selects the first matching item in the search list automatically as the user types.
Categories Gets or sets the category definitions used to filter the search list.
CategoryButton Gets or sets the appearance and behavior of the category pop-up button.
Columns Gets or sets the column definitions used to display item data.
DropDownHeight Gets or sets the height of the drop-down list in pixels.
DropDownWidth Gets or sets the width of the drop-down list in pixels.
Edit Provides access to the embedded drop-down edit button.
EmptyText Gets or sets the placeholder text shown when the edit is empty.
FilterCondition Gets or sets the matching conditions used to filter items.
ItemHeight Gets or sets the height of each item row in the drop-down list.
ItemIndex Gets or sets the index of the currently selected item.
Items Gets or sets the collection of items shown in the search list.
SearchButton Gets or sets the appearance and behavior of the search action button.
SearchList Provides access to the embedded search list control.
SelLength Gets or sets the length of the edit selection.
SelStart Gets or sets the start position of the edit selection.
Text Gets or sets the current text in the edit control.

Methods

Name Description
BeginUpdate Begins a batched update of the control.
EndUpdate Ends a batched update and repaints any pending changes.
LoadStrings Populates the item collection from a string list.
ReInit Rebuilds the internal search list and resets the edit state after items or categories change.
UpdateFilter Reapplies the active filter to the item collection.

Events

Name Description
OnBeforeDropDown Fires before the drop-down list opens.
OnCategoryItemClick Fires when a category menu item is clicked.
OnChange Fires when the edit text changes.
OnDropDown Fires when the drop-down list opens.
OnDropUp Fires when the drop-down list closes.
OnSearchButtonClick Fires when the search button is clicked.
OnSelect Fires when an item is selected from the drop-down list.

Used by