SftBox/OCX 4.5

SftBoxDropDown.CharSearchMode Property

Softel vdm, Inc.

Defines the search mode for characters typed by the user.

Syntax       

Get

VB.NET

Mode = object.CharSearchMode  As SftBoxCharSearchModeConstants

VB

Mode = object.CharSearchMode  As SftBoxCharSearchModeConstants

C#.NET

SftBoxCharSearchModeConstants Mode = object.CharSearchMode;

VC++

enum SftBoxCharSearchModeConstants Mode = object->CharSearchMode;
enum SftBoxCharSearchModeConstants Mode = object->GetCharSearchMode();

C

HRESULT object->get_CharSearchMode(enum SftBoxCharSearchModeConstants* Mode);

Delphi

Mode := object.CharSearchMode  : TOleEnum;

Put

VB.NET

object.CharSearchMode = Mode  As SftBoxCharSearchModeConstants

VB

object.CharSearchMode = Mode  As SftBoxCharSearchModeConstants

C#.NET

SftBoxCharSearchModeConstants object.CharSearchMode = Mode;

VC++

enum SftBoxCharSearchModeConstants object->CharSearchMode = Mode;
void object->PutCharSearchMode(enum SftBoxCharSearchModeConstants Mode);

C

HRESULT object->put_CharSearchMode(enum SftBoxCharSearchModeConstants Mode);

Delphi

object.CharSearchMode := Mode  : TOleEnum;

object

A SftBoxDropDown object.

Mode

Defines the search mode for characters typed by the user. 

Simple or drop down combo box:

Mode

Value

Description

charSearchModeSftBoxFull

0

If 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.

charSearchModeSftBoxNone

1

No item searching is attempted. The application can implement its own matching mechanism using the EditChange and EditUpdate events.

charSearchModeSftBoxManual

2

No item searching is attempted, but the application can select an item in response to the EditChange event.

charSearchModeSftBoxPartial

3

If 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.

charSearchModeSftBoxAutoComplete

4

If 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).

charSearchModeSftBoxFull2

5

Full - Like charSearchModeSftBoxFull, but does not automatically expand collapsed parent items.

charSearchModeSftBoxPartial2

6

Partial - Like charSearchModeSftBoxPartial, but does not automatically expand collapsed parent items.

charSearchModeSftBoxAutoComplete2

7

AutoComplete - Like charSearchModeSftBoxAutoComplete, but does not automatically expand collapsed parent items.

Drop down list combo box:

Mode

Value

Description

charSearchModeSftBoxFull

0

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.

charSearchModeSftBoxNone

1

No item searching is attempted. The application can implement its own matching mechanism using the KeyDown and KeyPress events.

charSearchModeSftBoxManual

2

Same as charSearchModeSftBoxNone. No item searching is attempted. The application can implement its own matching mechanism using the KeyDown and KeyPress events.

charSearchModeSftBoxPartial

3

Starting at the current item, the next item starting with the one single character typed is located and selected.

charSearchModeSftBoxAutoComplete

4

Same 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.

charSearchModeSftBoxFull2

5

Full - Like charSearchModeSftBoxFull, but does not automatically expand collapsed parent items.

charSearchModeSftBoxPartial2

6

Partial - Like charSearchModeSftBoxPartial, but does not automatically expand collapsed parent items.

charSearchModeSftBoxAutoComplete2

7

AutoComplete - 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.


Feedback / comments / error reports for this topic
© 2008 - Softel vdm, Inc. - www.softelvdm.com