<< Click to Display Table of Contents >> Navigation: Object Reference > General Objects > Softkey Frames and Softkey Levels |
Softkey frames are (at default) invisible containers for softkey levels. Softkey levels contain the softkeys.
A Softkey frame can have up to 4 softkey levels. Softkey levels can be used if there is not enough space on the screen to show all softkeys. At runtime it is possible to switch to another softkey level to show different softkeys.
At default two softkey frames frames are created for each page automatically each containing one softkey level. To create a new softkey frame open the page from project tree and do a right click on the DataMask object of the page in the project tree and select Create Softkey Frame XXX (XXX is either Left or Right for landscape devices or Bottom or Top for portrait devices). If all softkey frames for the page already exist, this option will not be available on right click. After softkey frame contains one default softkey level. To create more levels do a right click on the softkey frame in the project tree and select Create Softkey Level. The new created level will then directly be shown. To switch between the levels in the designer, the level that shall be shown can also be selected via right click on the softkey frame in the project tree. To switch between softkey levels at runtime, the actions Next Softkey Level or Previous Softkey Level can be attached to a softkey. |
For a list of other common properties of a softkey frame that are shared with other objects see here. Softkey WidthAs default softkeys have a calculated size so that no gaps exist between the softkeys. With this properties it is possible to make the softkey width smaller in a bottom or top softkey frame so that gaps between the softkeys are possible. Default value: Calculated based on device Possible values: Anything smaller than the calculated value This property can only be changed for top or bottom softkey frames. For left or right softkey frames the width of the softkeys is directly connected to the width of the softkey frame. Softkey HeightAs default softkeys have a calculated size so that no gaps exist between the softkeys. With this properties it is possible to make the softkey height smaller in a left or right softkey frame so that gaps between the softkeys are possible. Default value: Calculated based on device Possible values: Anything smaller than the calculated value This property can only be changed for left or right softkey frames. For top or bottom softkey frames the height of the softkeys is directly connected to the height of the softkey frame. Current Softkey LevelThe Current Softkey Level property is not visible in the designer tool and can only be accessed at runtime via JavaScript. With this property the currently shown softkey level can be changed. Note: it is also possible to change the softkey levels via the variable @ChangeSoftkeyLevel (see variable table for description). |
The following events can be configured for the softkey frame: •OnPress •OnRelease Note: These events are only triggered if there are no input objects on the page. Otherwise navigation scheme uses the touch events for input objects only and the softkey frame is not considered an input object. See here for the descriptions of all event and possible actions that can be assigned. |