Data List Commands - Rules; Ldt; Ldl - AMX MIO-R4 Operation/Reference Manual

Data List Commands (Cont.)

^LDT

Set column type

^LDL

Modify data in a single
column

Data List Commands - Rules

The following rules apply to the ^LDA, ^LDR and ^LDL Data List Commands:
TPDesign4 Touch Panel Design Software (v2.10 or higher)
Sets the column type for a data list. Column is the index of the first type to set,
additional types sent are set in order.
Syntax:
"'^LDT-<list address>,<column>,<type>,<type>,...'"
Variables:
• list address = address where data resides
• column = the starting column number
• type = subsequent columns. 0 - Text; 3 - Channel; 4 - Page
Example:
SEND_COMMAND Keypad, "'^LDT-1,1,0,0,0'"
Sets the column type for the data list located at address 1. The column type
starts at column 1, the first column is Text, the second and third columns are
also Text.
Modifies the data in a single column field. This can be used to load a data list
that has long text fields.
Syntax:
"'^LDL-<list address>,<column>,<uniflag>,<primary
data>,<new cell data>'"
Variables:
• list address = address where data resides
• column = the starting column number; numbering starts at 1
• uniflag = indicates unicode; 0 - No unicode, 1 - Uses unicode
• primary data = the "key" data column. The information in this column provides
each row with its uniqueness.
• new cell data = data information for a single field or "cell"
Example:
SEND_COMMAND Keypad, "'^LDL-1,1,0,Entry5,Music'"
The field located in column 1, in the row with the primary data "Entry5" and in
the data list located at the address of 1 is a text value of Music.
Leading and trailing spaces are ignored before and after opening and closing double quotes.
Double quotes must be the first non-space character after the previous delimiter (,) and the last
non-space character before the following delimiter (or end of command).
Within double quotes, the backslash (\) is used as an escape character. This is to allow double
quote literals within the string bounded by double quotes. When a backslash is parsed, the
next character is read as a literal value and the backslash is discarded.
There are 2 cases in which you would use the backslash to escape a double quote literal within
the field, to escape another backslash (commas do not need to be escaped).
Any data field that has a double quote literal as its first character MUST use double quotes to
delimit the field, then use the backslash to escape the double quote literal.
List box commands contain comma-delimited fields, but you can use commas within the
fields. Use double-quotes to surround fields in which commas are needed.
List Box Buttons
105