Txt; Uni - AMX Modero G5 Instruction Manual

Programming - Send Commands
Button State Commands (Cont.)

?TXT

^UNI

94
Query State Text Command.
Syntax:
"'?TXT-<vt addr range>,<button states range>[,<optional index>]'"
Variables:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and
2 = On state).
optional index = This is used if a string was too long to get back in one command. The reply will start at this
index.
The response returned is a custom event with the following syntax:
Custom.ID = button address
Custom.Type = 1001
Custom.Flag =
0: Legacy Latin-1 (ISO-8859-1) encoded characters (^ENC must have previously been sent to change
default encoding method)
1: Legacy AMX Hex Quad encoded Unicode characters
2: UTF-8 encoded Characters (default encoding; ASCII-compatible)
Custom.Value1 = Button state number
Custom.Value2 = Actual length of string
Custom.Value3 = optional index
Custom.Text = Text from the button, encoded with the method specified by Flag
Example:
SEND_COMMAND Panel,"'?TXT-529,1'"
Gets the button 'OFF state' text information.
Example Response:
Custom.ID = 529
Custom.Type = 1001
Custom.Flag = 1 (non-unicode characters)
Custom.Value1 = 1 (button state)
Custom.Value2 = 14 (string length)
Custom.Value3 = 0 (optional index)
Custom.Text = This is a test (button text)
Set State Unicode Text Command. Set Unicode text. For the ^UNI command, the Unicode text is sent as
ASCII-HEX nibbles.
Note: Unicode is always represented in a HEX value. TPD generates (through the Text Enter Box dialog)
unicode HEX values. Refer to the TPDesign Instruction Manual for more information. This command has been
replaced by ^UTF, but is being kept for backwards compatibility.
Syntax:
"'^UNI-<vt addr range>,<button states range>,<unicode text>'"
Variables:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and
2 = On state).
unicode text = Unicode HEX value.
Examples:
SEND_COMMAND Panel,"'^UNI-500,1,0041'"
Sets the button's unicode character to 'A'.
SEND_COMMAND TP,"'^UNI-1,0,0041'"
Send the variable text 'A' in unicode to all states of the variable text button 1, (for which the character code
is 0041 Hex).
Modero G5 Touch Panels - Configuration and Programming