• a5_activate_phone Function
• A5_ADDIN_MANAGER Function
• a5_append_op_result Function
• a5_argumentsdialog Function
• a5_configure_update_chk Function
• a5_copy_op_result Function
• a5_defaultbrowseonxdialog Function
• A5_EDIT_SPEED_GLOSSARY Function
• a5_export_op_result Function
• a5_fixxdialogpositions Function
• A5_GENERIC_PRINT Function
• A5_GENERICSEARCHREPLACE Function
• a5_genieheadinghtml Function
• a5_get_toolbar_xdialog Function
• a5_global_search_scripts Function
• a5_gridcomponentopeninwindow Function
• a5_imp_append_op_result Function
• a5_is_find_by_key_open Function
• a5_linktoolbar Function
• a5_mark_op_result Function
• A5_OWNER_DRAW_LIST_FMT Function
• a5_paste_special Function
• a5_post_op_result Function
• A5_PROMPT_FOR_IMAGENAME Function
• a5_request_activation Function
• a5_selectwinusers Function
• a5_sendexportorprint_code Function
• a5_setamyuniprops Function
• a5_showpopuphelp Function
• a5_update_op_result Function
• a5_wait_xdialog Function
• a5_xd_genie_listvcodeget Function
• a5_xd_genie_simplechartcodeget Function
• a5_xdialog_builder_genie Function
• a5_xdialog_font_override Function
• a5_xdialog_preprocess Function
• A5_XdialogPreProcess Function
• a5_zip_db_dialog Function
• ShowDiff Function
• TextToSpeech Function
• UI_WAIT_UNTIL Function
• Xdialog_Play Function

UI_WAIT_UNTIL Function

Syntax

Arguments

event

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

every

Optional. Default = .001 seconds. The interval in seconds between checks of Logical_Expression.

timeout

Optional. Default = forever. The number of seconds to wait before returning to the script, regardless of Logical_Expression.

Description

The UI_WAIT_UNTIL()pauses a script until UI_MODELESS_DLG_EXIST() returns .T. (TRUE) or .F. (FALSE). Use this function when the testing if some UI component is present.

Discussion

When the Logical_Expression is .T., the function sets Result_Flag to .T.. If, after the interval specified by Timeout_After, the Logical_Expression is still not TRUE, the function sets Result_Flag to .F. (FALSE). If Timeout_After is not specified, then Alpha Five will wait indefinitely until the Logical_Expression is .T.. UI_WAIT_UNTIL Function is exactly like WAIT_UNTIL function, except it processes pending UI *before* if goes into a wait loop. This should be used when condition is ui bound (i.e. while xdialog exists).

Example

dim code as c
code = <<%code%
ui_modeless_dlg_exist("MyModelessXdialog") = .f.
%code%
flag_result = ui_wait_until(code)
if flag_result = .t. then
       'specify code here that executes when MyModelessXdialog has closed
end if

Limitations

Desktop applications only.

See Also

• WAIT_UNTIL()