CALL
Description
Calls an ancestor script from a script for a descendent object.
You can call scripts for events in an ancestor of the user object,
menu, or window. You can also call scripts for events for controls
in an ancestor of the user object or window.
When you use the CALL statement to call
an ancestor event script, the AncestorReturnValue variable is generated.
For more information on the AncestorReturnValue variable, see “About events”.
Syntax
|
1 |
CALL <span>ancestorobject</span> {`<span>controlname</span>}::<span>event</span> |
|
Parameter |
Description |
|---|---|
|
ancestorobject |
An ancestor of the descendent object |
|
controlname |
The name of a control in an ancestor |
|
event |
An event in the ancestor object |
Usage
Using the standard syntax
For most purposes, you should use the standard syntax for
calling functions and events. For more information about the standard
syntax, see “Syntax for calling PowerBuilder
functions and events”.
The standard syntax allows you to trigger or post an event
or function in an ancestor and then pass arguments, but it does
not allow you to call a script for a control in the ancestor.
In some circumstances, you can use the pronoun Super when ancestorobject is the
descendant object’s immediate ancestor. See the discussion
of “Super pronoun”.
If the call is being made to an ancestor event, the arguments
passed to the current event are automatically propagated to the
ancestor event. If you call a non-ancestor event and pass arguments,
you need to use the new syntax, otherwise null will
be passed for each argument.
Examples
This statement calls a script for an event in an ancestor
window:
|
1 |
CALL w_emp::Open |
This statement calls a script for an event in a control in
an ancestor window:
|
1 |
CALL w_emp`cb_close::Clicked |