SftMask/OCX 6.5

SftMask.MatchAccept Event

Softel vdm, Inc.

The user has accepted an autocomplete text entry.

Syntax       

VB.NET

Private Sub object_MatchAccept(ByVal sender As Object, ByVal e As EventArgumentType) Handles object.MatchAccept

VB

Private Sub object_MatchAccept(ByVal Text As String, EntryText As String, Accept As Boolean)

C#.NET

void object_MatchAccept(object sender, EventArgumentType e);

VC++

void OnMatchAcceptobject(_bstr_t Text, _bstr_t* EntryText, VARIANT_BOOL* Accept);

C

HRESULT OnMatchAcceptobject(BSTR Text, BSTR* EntryText, VARIANT_BOOL* Accept);

Delphi

procedure objectMatchAccept(Sender: TObject; Text : WideString; var EntryText : WideString; var Accept : WordBool);

object

A SftMask object.

Text

A string containing the current control contents. Equivalent to the Text property (including all literals, regardless of the current ClipMode settings).

EntryText

A string containing the autocomplete entry selected by the user. The EntryText parameter can be modified to change the text.

Accept

A Boolean value. If True is returned, the autocomplete text entry is used to update the control contents. If False is returned, the selected autocomplete text entry is discarded. The default is True.

Comments

The MatchAccept event occurs when the user has accepted an autocomplete text entry.

The MatchAccept event can be used to reject or modify an autocomplete entry that the user has selected and accepted.

If a custom autocomplete entry is accepted by the user, the MatchCustom event occurs instead of the MatchAccept event.

While handling this event, the Masked Edit control must not be updated through its methods or properties.

The MatchAccept event only occurs when AutoComplete.Mode is set to autocompleteSftMaskSuggest or autocompleteSftMaskSuggestAppend, the entry list is displayed and the user makes and accepts a selection. This event does not occur for other modes.


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