{dialog.object}runAction Method
Syntax
Arguments
- actionNamestring
The action to run.
- eleobject
A pointer to a DOM element. This is only required if the action performs a task that is relative to other controls in the component, such as opening a window in a dropdown or positioned relative to another object. Use {dialog.object}.getPointer() to get a pointer to a control in the UX.
Description
Runs an action that was defined using the Action Script builder.
Discussion
Runs an action that was defined using the Action javascript builder. You can optionally pass in a pointer to the object that invokes the action.
Passing in a pointer to the element that invokes the action is necessary when the action you are running opens a 'dropdown' window or a window positioned relative to an object.
Running an Action
To run an action, simply call {dialog.object}.runAction with the name of the action to execute.
{dialog.object}.runAction('report1');
Passing in a Pointer to an Element
Some actions, such as opening a window in a dropdown or a window that is positioned relative to another control, require additional information provided by passing an element to the {dialog.object}.runAction method. You can pass the this pointer to the method to accomplish the task:
{dialog.object}.runAction('openUX',this);
You can also pass in a different element in your component. For example, suppose you wanted the popup window to appear relative to a List control when the action is invoked:
//Get a pointer to the list control var ele = {dialog.object}.getPointer('LIST1'); // Run the action {dialog.object}.runAction('openUX', ele);
See Also