Tag 011 - Static and Scrolling Text with Optional Buttons

The Static and ScrollingText with Optional Buttons Message can be used to display both static (non-scrolling) and scrolling user text on the same screen, as well as optional buttons. Buttons and static text and scrolling text are placed in three screen areas, whose heights can be configured (0 = do not display). These areas are, from top to bottom:

Button area – Up to four virtual buttons can be displayed at the top of the screen. As for Tag 010, a virtual button will only be displayed if data is entered in the request descriptor field for the button (ButtonNDesc). The vertical extent of this area is defined (as a percentage of screen height) by a request field; 20(%) is recommended. Buttons are centered in the button area. Button descriptor font size is defined by a request field (see samples below). Maximum button descriptor length is device-specific.

Static text area – The vertical extent of this area is defined (as a percentage of screen height) by a request field. Other request fields define the font size and justification of static text.

Scrolling text area – The vertical extent of this area is whatever is left over after the first two areas. Other request fields define the font size and justification of scrolling text.

For both text areas: See below for sample font sizes. The maximum number of characters per line depends on the font size and device. The maximum number of lines in an area depends on the height of the area, the font size, and the device.

Pressing the Enter key is not required after pressing a virtual button.

The Static and Scrolling Text with Optional Buttons Response returns the button pressed by the customer. Request fields (AllowEnter, AllowCancel) control whether the (hard) Enter and Cancel keys can be used.

Field 5001 Format

Request

note

Field separators must be sent for both button and label fields as shown below, even if some of these fields are null.

Field 5001 SubfieldLengthDescription
TTT3Tag (always = 011)
LLL3Length of the following data
AllowEnter1Allow Enter hard key (0=Not allow, 1=Allow)
AllowCancel1Allow Cancel hard key (0=Not allow, 1=Allow)
Beeper1Sound tone (0=No, 1=Yes)
FS1Field separator (Hex 1C)
ButtonAreaHeight2Height of Button area (as % of screen height)
FS1Field separator (Hex 1C)
ButtonFontSize1Button descriptor font size (0 = extra small to 6 = extra large)
FS1Field separator (Hex 1C)
ButtonADescVar.Descriptor for first button position (from left) on top (A)
FS1Field separator (Hex 1C)
ButtonBDescVar.Descriptor for second button position on top (B)
FS1Field separator (Hex 1C)
ButtonCDescVar.Descriptor for third button position on top (C)
FS1Field separator (Hex 1C)
ButtonDDescVar.Descriptor for fourth button position on top (D)
FS1Field separator (Hex 1C)
StaticTextAreaHeight2Height of Static text area (as % of screen height)
FS1Field separator (Hex 1C)
StaticTextFontSize1Static text font size (0 = extra small to 6 = extra large)
FS1Field separator (Hex 1C)
StaticTextJust1Static text justification (1=Left; 2=Center; 3=Right)
FS1Field separator (Hex 1C)
StaticTextVar.Static text defined in semi-colon (;) delimited lines
FS1Field separator (Hex 1C)
ScrollingTextFontSize1Scrolling text font size (0 = extra small to 6 = extra large)
FS1Field separator (Hex 1C)
ScrollingTextJust1Scrolling text justification (1=Left; 2=Center; 3=Right)
FS1Field separator (Hex 1C)
ScrollingText1Var.First line of scrolling text
FS1Field separator (Hex 1C)
ScrollingTextLastVar.Last line of scrolling text

Response

Field 5001 SubfieldLengthDescription
TTT3Tag (always = 011)
LLL3Length of the following data
ActionButtonVar.If field 11 Completion Code = 000 (success), returns code for action button or key pressed:
    777=Enter (green) key
    888=Cancel (red) key
    1=ButtonA
    2=ButtonB
    3=ButtonC
    4=ButtonD

Sample Message (Four Buttons)

Request

The following request tells Simplify to display the screen shown below (start of scrolling text is shown):

API Field #, ValueDescription
0001,36Transaction Type
0011,14123010120User Data. See Field 11 (User Data).
5001,[see value below]Non-Financial Data
    011=Tag
    934=Length of data
    1=Allow Enter key
    1=Allow Cancel key
    1=Beeper active
    20=Height (%) of Button area
    3=Button descriptor font size
    Button 1=Descriptor for virtual button position A
    (etc.)
    40=Height (%) of static text area
    3=Static text font size
    2=Static text justification
    Text1=Text of static line 1
    ;=Delimiter for text of static line 1
    (etc.)
    2=Scrolling text font size
    2=Scrolling text justification
    You agree that any Services contain proprietary content, information=Text of scrolling line 1
    (etc.)

5001,011934111FS20FS3FSButton1FSButton2FSButton3FSButton4FS40FS3FS2FSText 1;Text 2;Text 3;Text 4FS2FS2FSYou agree that any Services contain proprietary content, informationFS and material that is protected by intellectual property (etc.)

sample screen with four buttons

Response

API Field #, ValueDescription
0001,36Transaction Type
0011,14123011000User Data. See Field 11 (User Data).
5001,0110003777Non-Financial Data
    011=Tag
    003=Length of data
    777=Enter key pressed

Sample Message (Two Buttons)

Request

The following request tells Simplify to display the screen shown below (start of scrolling text is shown):

API Field #, ValueDescription
0001,36Transaction Type
0011,14124011000User Data. See Field 11 (User Data).
5001,[see value below]Non-Financial Data
    011=Tag
    899=Length of data
    1=Allow Enter key
    1=Allow Cancel key
    1=Beeper active
    20=Height (%) of Button area
    3=Button descriptor font size
    Button 1=Descriptor for virtual button position A
    (etc.)
    10=Height (%) of static text area
    2=Static text font size
    2=Static text justification
    Text1=Text of static line 1
    2=Scrolling text font size
    2=Scrolling text justification
    You agree that any Services contain proprietary content, information=Text of scrolling line 1
    and material that is protected by applicable intellectual property =Text of scrolling line 2
    (etc.)

5001,011899111FS20FS2FSButton1FSFSFSButton2FS10FS2FS2FSText 1FS2FS2FSYou agree that any Services contain proprietary content, information FS and material that is protected by applicable intellectual property (etc.)

sample screen with two buttons

Response

API Field #, ValueDescription
0001,36Transaction Type
0011,14123011000User Data. See Field 11 (User Data).
5001,0110003888Non-Financial Data
    011=Tag
    003=Length of data
    888=Cancel key pressed