Fig. 16: Button control - General 1 page
z Button: The type of button is defined with these radio buttons. The
appearance of the General 2 page depends on what is selected here.
z Menu button: This button type is only available at connection of
Internet pages. A menu button is used to call a menu of business transactions. This type of button differs from a selection button in that it is possible to define for each function whether customers have to identify themselves with a card and PIN, or whether no authorization at all is required (see "Menu buttons" on
page 67).This radio button will not be selectable, if the parameter ButtonInstallation (see "ButtonInstallation" on page 652 in the Parameters chapter) is set to 1.
The Button control Controls
z Function key: Function keys are buttons with a special meaning such as
Cancel, Correct or Confirm. All such keys can be placed in an HTML frame of their own are listed here (see also ’Function keys’ on page 64). This frame remains in the same position throughout the application. The function keys can be made visible or hidden from the active HTML frame. The destination Internet page when a key is pressed is also controlled from the active HTML frame. For this reason, no Internet page can be specified on the General 2 page as far as function keys are
concerned.
Fig. 18: Help function key
z Selection button: A selection button is any button in the active frame.
Pressing such a button can either return a response to the calling Transaction FW class or take the customer directly to a new page in special situations, e.g. if a new window is to be closed (see also ’Selection buttons’ on page 66).
Pressing such a button takes the customer directly to a new page (see also ’Selection buttons’ on page 66).
Fig. 19: Selection button for an amount in DM
z Radio button: Radio buttons always appear in groups of at least two. One
of these radio buttons must be in the pressed state. If another radio button in this group is selected, the previously active one returns to the
up state. If no radio button is defined as having the pressed state when
the group is created, the Contents (STD/ATM) control (see "The Contents ATM control" on page 198) ensures that the radio button with the lowest field ID (see "Button control - General 2 page for function keys" on page 86) is automatically placed in the pressed state.
Controls The Button control
z Toggle: This group defines whether a button is a Windows check box. With
this option it is possible, for example, to implement a button indicating that a customer card has been input. The button has the pressed state when no card is in the device. Once a card has been inserted, a Transaction FW class will set the button to up by setting the appropriate Viewstate variable and loading the same page again. The card is ejected when the customer presses this button. When this button is created, Toggle must be set to yes.
z no: This – the standard setting – determines that the button functions as
required.
When the button is pressed, the return code is sent to the application.
When the button is pressed, a Transaction FW class is called or an Internet page is opened, depending on the settings on the General 2 page (see "Button control - General 2 page for selection buttons" on page 91).
z yes: If this setting is selected, a Button control is treated like a Windows
check box, i.e. when the button is selected it gets the pressed state, and the value of the button is entered in the VAR_DLG_INPUT_RESULT_S variable.
The return code is sent to the application. It can call the same Internet page with a changed Viewstate pressed for this button.
The call of a Transaction FW class should be parameterized for a toggle button (see "Button control - General 2 page for selection buttons" on page 91). This class can buffer the value of the button and send a return code for which no Internet page has been specified. The page that has been loaded is retained. Several toggle buttons can be queried in this way.
z default: If default is selected, the content of the HoldPressedState
parameter is evaluated at runtime (see also ’HoldPressedState’ on page 656). This parameter may contain 0 for no or 1 for yes.
The Button control Controls
z State: The state of a button upon loading of an Internet page is configured
here. The various states can, however, be overwritten by the settings of variables in the application (see "Hiding controls with Viewstate variables" on page 274).
z Button up: When the page is loaded, the button shows the image that is
defined in the Button up parameter on the Graphic page (see "Button control - Graphic page" on page 105). In this state, the button can be pressed by the customer.
z Button pressed: When the page is loaded, the button shows the image
that is defined in the Button pressed parameter on the Graphic page (see "Button control - Graphic page" on page 105). In this state, too, the button can be pressed by the customer. Pressing it changes its state to
up. It is only possible to load the button with this image when the Toggle lock parameter has been set to yes.
z Button disabled: When the page is loaded, the button shows the image
that is defined in the Button disabled parameter on the Graphic page (see "Button control - Graphic page" on page 105). In this state, the button cannot be pressed by the customer.
z Button hidden: The button does exist on the page but it is not visible in
this state.
z Shift in pixels: This input field is used to specify the number of pixels by
which the caption and icon are shifted to the right and down when the button is selected in order to give the optical impression of a pressed button. The number of pixels depends on the design of the button images. If the optical impression is conveyed that the button protrudes about 3 pixels, then 3 has to be input here.
z default: If this check box is activated, the value of the shift in pixels is read
from the PressOffset parameter at runtime (see also ’PressOffset’ on page 653). By changing this parameter it is therefore possible to give a different appearance in one action to all buttons whose shift in pixels has been set to default.
Controls The Button control