Hide

SftBox/OCX 5.0 - Combo Box Control

Display
Print

SftBoxDropDown.CharSearchMode Property

Defines the search mode for characters typed by the user.

Syntax

Get

VB.NETMode = object.CharSearchMode As SftBoxCharSearchModeConstants
VBMode = object.CharSearchMode As SftBoxCharSearchModeConstants
C#.NETSftBoxCharSearchModeConstants Mode = object.CharSearchMode;
VC++enum SftBoxCharSearchModeConstants Mode = object->CharSearchMode;
enum SftBoxCharSearchModeConstants Mode = object->GetCharSearchMode();
CHRESULT object->get_CharSearchMode(enum SftBoxCharSearchModeConstants* Mode);

Put

VB.NETobject.CharSearchMode = Mode As SftBoxCharSearchModeConstants
VBobject.CharSearchMode = Mode As SftBoxCharSearchModeConstants
C#.NETSftBoxCharSearchModeConstants object.CharSearchMode = Mode;
VC++enum SftBoxCharSearchModeConstants object->CharSearchMode = Mode;
void object->PutCharSearchMode(enum SftBoxCharSearchModeConstants Mode);
CHRESULT object->put_CharSearchMode(enum SftBoxCharSearchModeConstants Mode);

object

A SftBoxDropDown object.

Mode

Defines the search mode for characters typed by the user.

Simple or drop down combo box:

ModeValueDescription
charSearchModeSftBoxFull0If the complete contents of the edit control portion match any item in the column defined by CharSearchColumn completely, that item is selected. All items are searched.
charSearchModeSftBoxNone1No item searching is attempted. The application can implement its own matching mechanism using the EditChange and EditUpdate events.
charSearchModeSftBoxManual2No item searching is attempted, but the application can select an item in response to the EditChange event.
charSearchModeSftBoxPartial3If the contents of the edit control portion match any item in the column defined by CharSearchColumn partially or completely, that item is selected. The edit control portion is not updated. All items are searched.
charSearchModeSftBoxAutoComplete4If the contents of the edit control portion match any item in the column defined by CharSearchColumn partially or completely, that item is selected and the edit control portion is updated. Text that has not been explicitly entered by the user is highlighted (i.e., becomes the currently selected text). Auto completion of text entered is only available if the column defined by CharSearchColumn allows one single line of text only (see Column.CellMultiline).
charSearchModeSftBoxFull25Full - Like charSearchModeSftBoxFull, but does not automatically expand collapsed parent items.
charSearchModeSftBoxPartial26Partial - Like charSearchModeSftBoxPartial, but does not automatically expand collapsed parent items.
charSearchModeSftBoxAutoComplete27AutoComplete - Like charSearchModeSftBoxAutoComplete, but does not automatically expand collapsed parent items.

Drop down list combo box:

ModeValueDescription
charSearchModeSftBoxFull0The first item in the drop down portion control that matches the character(s) typed within a short time period is selected. As the user types additional characters the search continues. If the user pauses for more than one second, the search ends. The next character typed starts a new search. All items are searched.
charSearchModeSftBoxNone1No item searching is attempted. The application can implement its own matching mechanism using the KeyDown and KeyPress events.
charSearchModeSftBoxManual2Same as charSearchModeSftBoxNone. No item searching is attempted. The application can implement its own matching mechanism using the KeyDown and KeyPress events.
charSearchModeSftBoxPartial3Starting at the current item, the next item starting with the one single character typed is located and selected.
charSearchModeSftBoxAutoComplete4Same as charSearchModeSftBoxFull. The first item in the drop down portion control that matches the character(s) typed within a short time period is selected. As the user types additional characters the search continues. If the user pauses for more than one second, the search ends. The next character typed starts a new search. All items are searched.
charSearchModeSftBoxFull25Full - Like charSearchModeSftBoxFull, but does not automatically expand collapsed parent items.
charSearchModeSftBoxPartial26Partial - Like charSearchModeSftBoxPartial, but does not automatically expand collapsed parent items.
charSearchModeSftBoxAutoComplete27AutoComplete - Like charSearchModeSftBoxAutoComplete, but does not automatically expand collapsed parent items.

Comments

The CharSearchMode property defines the search mode for characters typed by the user.

As the user types characters, the control can automatically select an item that matches the text entered.

See Also SftBoxDropDown Object | Object Hierarchy


Last Updated 08/13/2020 - (email)
© 2024 Softel vdm, Inc.