system.util.invokeLater

Description

This is an advanced scripting function. Invokes (calls) the given Python function object after all of the currently processing and pending events are done being processed, or after a specified delay. The function will be executed on the GUI, or event dispatch, thread. This is useful for events likepropertyChange events, where the script is called before any bindings are evaluated.

If you specify an optional time argument (number of milliseconds), the function will be invoked after all currently processing and pending events are processed plus the duration of that time.

Syntax

system.util. invokeLater( function [, delay] )

Parameters

PyObject function - A Python function object that will be invoked later, on the GUI, or event-dispatch, thread with no arguments.

int delay - A delay, in milliseconds, to wait before the function is invoked. The default is 0, which means it will be invoked after all currently pending events are processed. [optional]

Returns

nothing

Scope

Client

Code Examples

Code Snippet

# The code in the update/refresh button uses the 'date' property on the two 
# calendar components, which are bound to the current_timestamp property on their 
# parent. We want to simulate a button press when the window opens, but only 
# after the date properties' bindings have been evaluated.
 
if event.propertyName == 'current_timestamp':
   # Define a function to click the button
   def clickButton(button = event.source.parent.getComponent('Refresh')):
      import system
      button.doClick()
      system.gui.messageBox("Button has been clicked!")
 
   # Tell the system to invoke the function after
   # the current event has been processed
   system.util.invokeLater(clickButton)