Android EngineComponentCommands::GetMatchingChildObjects
DRD:DEV

Retrieve an array of child objects that match a recognition string.

Normally, this is only valid for window or other container components. If no matching child objects exist then the engine should return "<SAFS_NULL>".

Returns a character delimited string of child references. The first character in the returned string defines the delimiter used to separate the items.

Currently, the engine command processors only support returning the first child matching the recognition string.

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. Component
    An object reference or proxy reference to the component.

    A reference to a particular component previously returned from a call to getTopLevelWindows or getMatchingParentObject, or one of the other engine commands that return such references.

  2. Recognition
    Recognition string describing the children to find.

    The recognition string is normally considered to be relative to the parent Component provided. Thus, information identifying the parent should normally NOT be part of the provided recognition string. For details on Recognition strings see: Gui Object Recognition;

Examples:
[How To Read This Reference]