Silk Mobile

Table of Contents (Homepage)

ListSelect

ListSelect (SendReset, SendNavigation, Delay, Text, Color, Rounds, SendOnFind)

images/images/os-icons/os_blackberry_150x1500.png


Description:

Used to navigate lists in non-touch devices

Parameters:

  • Send Reset: Navigate to the list start

  • Send Navigation: Send to navigate in the list

  • Delay: Time to wait before sending a command (in milliseconds)

  • Text: To Identify - Select text to find

  • Color: Color to filter

  • Rounds: Maximum navigation rounds

  • Send on find: Text to enter when the text to find was found

Usage:

ListSelect (SendReset, SendNavigation, Delay, Text, Color, Rounds, SendOnFind)

Scenario: In the following example I will click on 'New' in order to post a new MemoPad on a BlackBerry device. After opening the menu (By using 'SendText({F12})' command), I will use the 'listSelect' command.

Command usage: In order to navigate lists in non-touch devices, you can use the 'listSelect' command, configuring where to start, maximum amount of steps, text to find, and it's color when found. You can also configure what to do when it is found.

Parameters:

  • Send Rest- Navigate to the list start – will be set to "up"

  • Send Navigation - Send to navigate in the list – will be set to "Down"

  • Delay - Time to wait before sending a command (in milliseconds) – set to "500"

  • Text To Identify- Select text to Find – will be set to "New"

  • Color - Color to filter – will be set to "0xFFFFFF" - (white)

  • Rounds - Maximum navigation rounds – will be set to "5"

  • Send on find - Send on text find – will be set to {ENTER} – click on it!

Code Examples

Java Example
if(client.listSelect("{UP}", "{DOWN}", 500, "New", "0xFFFFFF", 5, "{ENTER}")){
// If statement
}
C# Example
if(client.ListSelect("{UP}", "{DOWN}", 500, "New", "0xFFFFFF", 5, "{ENTER}")){
// If statement
}
VBScript Example
if StrComp (client.ListSelect ( "{UP}", "{DOWN}", 500, "New", "0xFFFFFF", 5, "{ENTER}" ), "True") = 0 Then
Report
'If statement
End if
Python Example
if(self.client.listSelect("{UP}", "{DOWN}", 500, "New", "0xFFFFFF", 5, "{ENTER}")):
# If statement
Pass
Perl Example
if($client->listSelect("{UP}", "{DOWN}", 500, "New", "0xFFFFFF", 5, "{ENTER}")){
# If statement
}