Prior_Object_Id - cUIObject

Called by the switch_back message to determine the object_id of the previous object to go to in the focus tree

Type: Function
Return Data Type: Handle

Parameters

Parameter	Type	Description
bNoDescend	Boolean	Controls whether the search for the prior object will descend levels of the focus tree. If it is false, the descent will take place.

Syntax

Function Prior_Object_Id Boolean bNoDescend Returns Handle

Call Example

Get Prior_Object_Id bNoDescend to HandleVariable

Description

The Prior_object_id function is called by the switch_back message to determine the object_id of the previous object to go to in the focus tree. The message is sent to the current object, which may use this message to change the destination of a navigation if necessary. The bNoDescend flag controls whether the search for the prior object will descend levels of the focus tree. If it is false, the descent will take place.

function prior_object_id integer skip_down returns integer
    integer new_obj
    move Self to new_obj
    repeat
        forward get prior_object_id of new_obj skip_down to new_obj
    until (ok_to_enter(new_obj))
    function_return new_obj
end_function

In the above example, the function is augmented to switch to objects that satisfy the condition ok_to_enter message. This will cause invalid objects to be skipped in the standard navigation scheme.

Return Value

If a value is returned, that's the object to move to. If zero is returned, no focus change should take place.