tsc_SoftkeyControl

This is a special type of control which can be added to a tsc_Form (or tsc_AppMainWindow).  Instead of appearing on the form it will appear on the softkeys area where the user can click it.

When it is clicked the x_Code will be sent to the appropriate overridden eventhandler:

tsc_Form             virtual void OnSoftkeyClick (x_Code softkey);

tsc_AppMainWindow    virtual void OnButtonClick  (x_Code button);

The x_Code that is passed to the event handler is the identifier (text argument) of the softkey generating the event.

Constructors

tsc_SoftkeyControl (x_Code text);

Constructs a softkey control which will be added to the form at the next position on the sofkeys row.  The next position value is then incremented.  The text argument is both the identifier for the control and the text to be displayed.  Up to 8 softkeys can be added in this way.

tsc_SoftkeyControl (x_Code text, int position);

Constructs a softkey control to be added to the form in the indicated position. The text argument is both the identifier for the control and the text to be displayed.  The supplied position must be between 0 and 7 inclusive.  Positions 0 to 3 are displayed in the softkey row at the bottom of the form when it is first shown; positions 4 to 7 are displayed only when the "softkey shift" button is pressed.  If the next position value is less than the supplied position, then it is incremented to the following position. 

Inherited methods

void SetVisible (bool visible);

Sets the visibility of the softkey.  A non-visible softkey consumes a position in the softkeys row, but displays nothing.

bool IsVisible  () const;

Returns the current visibility state.

Note: tsc_SoftkeyControls cannot be made read-only.