Android EngineComponentCommands::GetMatchingParentObject
DRD:DEV

Get a reference to the toplevel Window\Parent that matches the recognition string provided.

Locate a toplevel Window\Parent matching the recognition string and return a unique reference to that component. If no match is found the engine should return "<SAFS_NULL>".

The Android Engine also persists these values as SAFS variables. 

            ^DroidEngine.Command    = [command]
            ^DroidEngine.StatusCode = [statuscode string]
            ^DroidEngine.StatusInfo = [statusinfo]

See DEngineCommandProcessor.setStatusVars().



Fields: [ ]=Optional with Default Value
  1. Recognition
    Recognition string describing the Window\Parent to find.

    Topmost parent windows are usually identified with Type or Class information. The recognition string should uniquely identify the target window or incorrect matches will result.

    For details on Recognition strings see: Gui Object Recognition;



Examples:
[How To Read This Reference]