AddCustomActionButton - cWebBaseSelectionForm

Adds an action row to the suggestion popup

Parameters

Parameter	Type	Description
ByRef aItems	tSelectionItem[]	The suggestion item array being filled
sRowId	String	Unique identifier for the action row
sText	String	Text shown for the action row

Syntax

Procedure AddCustomActionButton ByRef tSelectionItem[] aItems String sRowId String sText

Call Example

Send AddCustomActionButton aItems sRowId sText

Description

Call AddCustomActionButton while filling suggestions to append an action row to the suggestion popup.

Action rows are displayed with the suggestions, but they are intended to start an action instead of selecting a normal value. Use a stable sRowId value so your code can recognize which action was selected.

The usual place to call AddCustomActionButton is from OnAddCustomActionButtons.

Procedure OnAddCustomActionButtons tSelectionItem[] ByRef aItems Boolean bLast String sFilter
    Forward Send OnAddCustomActionButtons (&aItems) bLast sFilter

    If (sFilter <> "") Begin
        Send AddCustomActionButton (&aItems) "newContact" "Create new contact"
    End
End_Procedure