SftMask.MatchCustom Event	Softel vdm, Inc.

The user has accepted a custom autocomplete entry.

Syntax       

		VB.NET	Private Sub object_MatchCustom(ByVal sender As Object, ByVal e As EventArgumentType) Handles object.MatchCustom
		VB	Private Sub object_MatchCustom(ByVal Text As String, ByVal EntryText As String, ByVal EntryType As Integer)
		C#.NET	void object_MatchCustom(object sender, EventArgumentType e);
		VC++	void OnMatchCustomobject(_bstr_t Text, _bstr_t EntryText, short EntryType);
		C	HRESULT OnMatchCustomobject(BSTR Text, BSTR EntryText, short EntryType);
		Delphi	procedure objectMatchCustom(Sender: TObject; Text : WideString; EntryText : WideString; EntryType : Smallint);

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 text of the custom autocomplete entry selected by the user.

EntryType

An Integer value. This value was used as the EntryType parameter of the AutoComplete.AddTop and AutoComplete.AddBottom methods. Using unique EntryType values for each custom entry, an application can recognize a selected entry without inspecting the text (EntryText).

Comments

The MatchCustom event occurs when the user has accepted a custom autocomplete entry.

Custom entries are always added to the list of autocomplete entries using the AutoComplete.AddTop and AddBottom methods. Custom entries are never saved (see AutoComplete.File property).

If an application adds custom entries, the MatchCustom event must be implemented to perform an action when the user selects a custom entry. There is no default action for custom entries. Custom entries are never used to update the control contents.

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

The MatchCustom event only occurs when AutoComplete.Mode is set to autocompleteSftMaskSuggest, the entry list is displayed and the user makes and accepts a selection of a custom entry added using AutoComplete.AddTop or AutoComplete.AddBottom. This event does not occur for other modes.

The Rollup method can be used to close the popup calendar, popup calculator and autocomplete window.