Android EngineComponentCommands::GetTopLevelWindows
DRD:DEV

Return references to all known top-level items (Windows).

The engine can only return references to those top-level items it has knowledge of. Not all engines can see all items. For example, Selenium only looks for Web clients. Some engines may only look for Java clients, etc.. Some engines can see other top-level items that are not Windows--like Processes, or Threads, etc...

The engine's array of objects will be returned as a delimited list of fields. The first character in the String will identify the separator used between each reference. If no top level windows were found then the engine will return an empty string.

The Android Engine also persists these values as SAFS variables. 

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

See DEngineCommandProcessor.setStatusVars().

The TestComplete Engine (TCAFS) also persists these values as SAFS variables. 

            
            ^TCAFS.Command    = [command]
            ^TCAFS.StatusCode = [statuscode string]
            ^TCAFS.StatusInfo = [statusinfo]
            ^TCAFS.UID.Count  = [Number of UID References created last]
            ^TCAFS.UID.1      = [First UID Reference created]
            ^TCAFS.UID.n      = [UID Reference number n]


Fields: [ ]=Optional with Default Value
    Examples:
    [How To Read This Reference]