List Box Buttons
108
TPDesign4 Touch Panel Design Software (v2.10 or higher)
Attaching a Dynamic List Data Table to a List Box Button
Once you have created a list Box Button, and defined List Data in your NetLinx Code (with Data List
Commands), you are ready to associate the List Data Table to the List Box Button. It is this association
that allows the data in the List Data to be displayed on the List Box Button.
1. In the Design View window, select the List Box Button that you want to associate with a List Data
Table.
2. In the General tab of the Properties Control Window, click inside either the List Table Port or the
List Table Address fields. Clicking inside these fields enables the browse (...) button. Click this
button to access the Attach Table To List Box dialog.
3. This dialog lists all Static List Data Tables in your project. Select the table that you want to attach to
the selected List Box Button.
4. Enter the Table Port and Table Address of the dynamic List Table.
5. Click OK to save your changes and close the dialog.
Example NetLinx Code with List Data
The following is a NetLinx code example using Data List Commands to define a listing of music tracks
to display on the associated List Box Button.
DEFINE_DEVICE
Keypad = 11001:1:4
Keypad2 = 11001:2:4
KeypadMusic = 11001:10:4
DEFINE_EVENT
BUTTON_EVENT[Keypad,5]
{
PUSH:
{
//Deletes any existing data list at address 1
SEND_COMMAND Keypad, "'^LDD-1'"
//Creates new 5-column data list at port 1, address 1 named "my music"
SEND_COMMAND Keypad, "'^LDN-1,1,5,my music'"
//Specifies column types for the data list at address 1 starting at column 1
SEND_COMMAND Keypad, "'^LDT-1,1,0,0,0,0,3'"
//Adds rows to the data list at address 1
SEND_COMMAND Keypad, "'^LDA-1,0,01,The Shins, Chutes Too Narrow, Kissing the Lipless, "10,1"'"
SEND_COMMAND Keypad, "'^LDA-1,0,02,The Shins, Chutes Too Narrow, "Mine''s Not a High Horse", "10,2"'"
SEND_COMMAND Keypad, "'^LDA-1,0,03,The Shins, Chutes Too Narrow, So Says I, "10,3"'"
SEND_COMMAND Keypad, "'^LDA-1,0,04,The Shins, Chutes Too Narrow, Young Pilgrim, "10,4"'"
SEND_COMMAND Keypad, "'^LDA-1,0,05,The Shins, Chutes Too Narrow, Saint Simon, "10,5"'"
SEND_COMMAND Keypad, "'^LDA-1,0,06,The Shins, Chutes Too Narrow, Fighting in a Sack, "10,6"'"
SEND_COMMAND Keypad, "'^LDA-1,0,07,The Shins, Chutes Too Narrow, Pink Bullets, "10,7"'"
SEND_COMMAND Keypad, "'^LDA-1,0,08,The Shins, Chutes Too Narrow, Turn a Square, "10,8"'"
SEND_COMMAND Keypad, "'^LDA-1,0,09,The Shins, Chutes Too Narrow, Gone for Good, "10,9"'"
SEND_COMMAND Keypad, "'^LDA-1,0,10,The Shins, Chutes Too Narrow, Those to Come, "10,10"'"
//Sets the column number (4) to display in the view with address 2
SEND_COMMAND Keypad, "'^LVC-2,4'"
//Updates the view at address 2
Command Structure List View Commands (Cont.)
^LVU
List view update
Update; this will update the view to any sort, filter, or list data changes.
Syntax:
"'^LVU-<view address>'"
Variable:
• view address = the address of the view definition
Example:
SEND_COMMAND Keypad, "'LVU-3'"
Updates the data list and displays it according to the view definitions located
at address 3.
Note: This must be called after changes to list data.