• a5_clip_library Function
• a5_export_scripts_udfs Function
• a5_get_actionscript_xbasic Function
• a5_is_actionscript Function
• a5_is_scr_being_edited Function
• a5_new_script_w_prompt Function
• a5_prmpt_script_name Function
• a5_save_script Function
• a5_script_create_new Function
• a5_script_favorites Function
• a5_script_favorites_menu Function
• a5_script_rename Function
• a5_scripteditor_popup Function
• a5_scriptgenie_multistep Function
• a5_scriptgenie_multistp2 Function
• a5_select_script_action Function
• A5_SETUP_ASK_VARS Function
• a5_what_being_edited Function
• EXPORT_SCRIPTS_AND_UDF Function
• export_scripts_and_udfs Function
• export_scripts_udfs Function
• IMPORT_SCRIPTS_UDF Function
• import_scripts_udfs Function
• load_compiled_script Function
• LOAD_LIBRARY Function
• ON_CONDITION Function
• script_drop Function
• script_exists Function
• SCRIPT_LOAD Function
• script_load_compiled Function
• SCRIPT_PLAY Function
• SCRIPT_PLAY_LOCAL Function
• script_rename Function
• script_save Function
• SCRIPT_SCHEDULE Function
• SCRIPT_SCHEDULE_NAME_GET Function
• SCRIPT_SCHEDULE_TIME_GET Function
• SCRIPT_SPAWN Function
• SCRIPTEDITOR_OPEN Function
• SLEEP Function
• UDF_LOAD Function
• VARIABLES_ENUM Function
• WAIT_UNTIL Function
• XBASIC_ASYNCHRONOUS Function
• XBASIC_SYNCHRONOUS Function
• XBASIC_WAIT_FOR_IDLE Function

ON_CONDITION Function

Syntax

Arguments

expressionCharacter

An Xbasic expression that resolves to either .T. (TRUE) or .F. (FALSE).

codeCharacter

The name of an Xbasic script or function to run.

Description

Run code (once) when condition is met.

Discussion

The ON_CONDITION() function registers some Code to be executed when a Logical_Expression is true. When the Logical_Expression is true, the Code is executed. After the code is executed, the ON_CONDITION() event is de-registered, so that the next time the Logical_Expression is true, the code no longer executed. You can register as many ON_CONDITION() events as you want. Generally, the ON_CONDITION() events will impose very little overhead on Alpha Anywhere. However, if your Logical_Expression is complex, and/or involves User Defined Functions, it is possible that the ON_CONDITION() events will represent a drain on performance.

It is important to recognize that when the condition is true the code executes, and then the condition is cleared. If you want something to happen every time a condition is met, then you must rerun the ON_CONDITION() command after the condition is met.

Example

The following example displays a message box the first time that the firstname field on the Customer_Information form gets focus:

Code = <<%code%
ui_msg_box("Notice", "Firstname is selected.")
%code%
on_condition("Customer_information.active() = 'firstname'", code)

See Also

• Script Functions