info("texteditortrigger")
info("texteditortrigger")

The info(“texteditortrigger”) function returns the reason why a Text Editor object triggered a procedure.

Description

This function is designed to be used in conjunction with a Text Editor Object (in a form). There are several different events that can cause a Text Editor Object to trigger a procedure – this function allows the programmer to determine which event has actually occurred. There are three possible values:

Start Editing This value indicates that text editing has just started. Either the user clicked in the object, or tabbed from another object into this one.

Finished Editing This value indicates that text editing has just finished. The user either clicked outside the object (for example on another field) or pressed a key that terminates editing (for example Tab, Return, or Enter).

Key This value indicates the text has just changed. Usually this means that a key was pressed that was inserted into the text, but it could also mean that text was deleted, or that the Cut command was used.

The object property inspector controls whether any of these events actually trigger the procedure. If an option is not checked, the procedure will not be triggered and you will never see the corresponding trigger value.

The Key value will be returned if either the Every Key or Most Keys options are checked. If Every Key is checked, the procedure will be triggered for every single key that is pressed. If the Most Keys option is checked, the procedure will only be triggered if there are no additional keys waiting to be pressed. This is usually the best option, as it prevents delays if several keys are pressed quickly in a row.

See Also

- Implicitly Triggered Procedures -- Procedures that are triggered automatically when the user performs some normal Panorama action are said to be "implicitly triggered."
- info("dialogtrigger") -- returns the name of the last button pressed in a standard alert or dialog.
- info("trigger") -- returns information about how the current procedure was triggered.
- setdialogtrigger -- changes the value returned by the info("dialogtrigger") function.
- settrigger -- changes the value returned by the info("trigger") function.
- Text Editor Object -- is used to edit text in a field or variable.

History

Version | Status | Notes
10.0 | New | New in this version