SftMask.MatchAddCustomItems Event	Softel vdm, Inc.

The control now accepts custom autocomplete entries.

Syntax       

		VB.NET	Private Sub object_MatchAddCustomItems(ByVal sender As Object, ByVal e As EventArgumentType) Handles object.MatchAddCustomItems
		VB	Private Sub object_MatchAddCustomItems(ByVal Count As Long)
		C#.NET	void object_MatchAddCustomItems(object sender, EventArgumentType e);
		VC++	void OnMatchAddCustomItemsobject(long Count);
		C	HRESULT OnMatchAddCustomItemsobject(long Count);
		Delphi	procedure objectMatchAddCustomItems(Sender: TObject; Count : Integer);

object

A SftMask object.

Count

The number of saved entries displayed in the list autocomplete entries.

Comments

The MatchAddCustomItems event occurs when the control accepts custom autocomplete entries.

The control is about to display the list of saved autocomplete entries. This event occurs so the application can add custom entries using the AutoComplete.AddTop and AddBottom methods.

This event occurs even if the list of saved entries is empty (Count is 0). If the application does not add a custom entry, the list is not displayed.

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.

While handling this event, the Masked Edit control must not be updated through its methods or properties, except using the AutoComplete.AddTop and AutoComplete.AddBottom methods.

The MatchAddCustomItems event only occurs when AutoComplete.Mode is set to autocompleteSftMaskSuggest. This event does not occur for other modes.