activeobjectaction
COMMAND
,
PARAMETER

The activeobjectaction statement allows a procedure to communicate with the object on the current form that is currently being edited (if any).


Parameters

This statement has two parameters:

command – is an instruction that will be sent to the target object. Different types of objects understand different types of commands.

parameter – Depending on the command, you may need additional parameters. For example, the Text Editor’s "InsertText" command requires one additional parameter which specifies the text to be inserted. Parameters may also receive values from the object. For example the Text Editor’s "GetSelection" command has two parameters: the starting and ending points of the selected text. If a parameter is used to receive a value from the object, that parameter must be a single field or variable with no operators (for example myValue, not myValue+yourValue or `strip(myValue))`.


Description

This statement allows a procedure to communicate with the form object that is currently being edited (if any). If nothing is being edited, this statement does nothing. Many types of objects have one or more commands that they understand. For example, the Text Editor Object has commands for selecting text, locating text, modifying text, etc.

This example inserts the current date and time into whatever object is currently being edited. This procedure will work with both Text Editor Objects and Word Processor Objects. The first few lines of the procedure check to make sure that there actually is an active object (i.e. something is really being edited at this time).

activeobjectaction "InsertText",
    datepattern( today(),"mm/dd/yy")+"@"+
    timepattern( now(),"hh:mm am/pm")

See Also


History

VersionStatusNotes
10.0No ChangeCarried over from Panorama 6.0, but has been renamed (this was formuerly called the activesuperobject statement). Also, the exact options for different kinds of statements are different.