target.set

Syntax	target.set (addr)
Params	addr is the Object Database address of the object you wish to become the target for future Frontier verb execution.
Action	Redirects all future Frontier verbs to the object at addr until a target.clear () or target.set (nil) resets the situation to its normal state.
Returns	The previous target, or nil if there was no previous target.
Examples	Open examples.list1 and examples.letter. Make sure examples.letter is the frontmost window. Now type and execute: local (oldTarget); msg ("The old target was: " + target.get ()); clock.waitSeconds (2); oldTarget = target.set (@examples.list1); msg ("The current target is: " + target.get ()); clock.waitSeconds (2); target.set (oldTarget); msg ("The target has been reset to: " + target.get ());
Notes	When the target is set, it is opened into a hidden window (if it wasn't already open in a window). You should always save the result of target.set in a local variable, so that you can restore the target when your script is finished with that object. Every thread has its own target, so you do not need to protect the target with semaphores. target.set (nil) is equivalent to target.clear ().