The ScriptFAYTCommandData object is passed to the script-defined entry points for any script add-ins that extend the FAYT field. The method name for these events is defined by the script itself, but generically it's referred to as OnScriptFAYTCommand.

Property Name Return Type Description

cmdline

string

Provides the text the user typed into the FAYT field.

fayt

string
or bool

The name of the FAYT extension command being invoked. This lets you use the same entry point to implement multiple FAYT extensions if desired. If the value is False then this is not a FAYT extension at all, but a regular script command.

flags

int

Provides the sum of all the flags the user has enabled for your FAYT extension. These come from the flags property you specified when initialising your extension via the ScriptFAYTCommand object.

Your script can update the flags in the users' configuration using the Script.UpdateFAYTFlags method.

key

string

This will equal the string "return" if the user pushed the return key to trigger your FAYT extension.

suggest

bool

If set to True this is a hint that you should update the suggestions list via the Tab.UpdateFAYTSuggestions method.

quickkey

string

Provides the key that initially triggered the FAYT in this mode.

tab

object:Tab

Represents the tab in which the FAYT is being interacted with.