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: Boolean bNoDescend

ParameterDescription
bNoDescendControls whether the search for the prior object will descend levels of the focus tree. If it is false, the descent will take place.


Return Value

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


Syntax
Function Prior_Object_Id Boolean bNoDescend Returns Handle

Call: 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.