User guide

Developers guidelines | AT commands
66 June 2010
AT*SELIST SEMC create list
<form> Description
Integer type Tells whether the GUI object should be placed in a
form or not
0 The object should not be placed in a form. Default
value
1 The object should be placed in a form
Description: Implements a List object and can also be used to create a submenu.
A List can consist of many items. Each item is composed of a text string
and an optional image. If the item does not have an image connected to it
the user must specify “” for the <item_image>. If an image is provided, the
implementation may choose to ignore the image if it exceeds the capacity
of the device to display it. If the implementation displays the image, it will
be displayed adjacent to the text string and the pair will be treated as a
unit.
Images within any particular List object should all be of the same size,
because the implementation is allowed to allocate the same amount of
vertical space for every element.
When creating a new List object, the user has to select which type of List,
<list_type>, that should be implemented, one-of-many, data list type or
Nbr-of-many list type.
When the user has made a selection in the list, the indexes of the selected
menu items are returned with the unsolicited result code *SEGUII. The
index is one-based (the first item has index 1). Other user actions such as
rejecting the list are also sent in the unsolicited *SEGUII.
To be able to use this command, a UI session has to be established. That
is, the AT command AT*SEUIS=1 has to be called before calling
AT*SELIST.
A list object dialog is deleted if AT*SEDEL=<object_index> is called.
Execution
command: AT*SELIST=<title>,<list_type>,<item_to_focus>,<number_of_items>,
<overlay_style>,<show>,<item_string1>,<item_image1>,<dimmed1>,
<selected1>,<delete1>[,<item_string2>,<item_image2>,<dimmed2>,
<selected2>,<delete2>...]
Execution command
response: *SELIST: <object_index>
Test command: AT*SELIST=? Shows if the command is supported.
Test command
response: *SELIST: (list of supported <list_type>s),(list of supported
<overlay_style>s),(list of supported <show>s)
Parameters:
<title>:
<title> Description
String Title of the list
<list_type>: