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 Width

As 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 Height

By 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 Level

The 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).

ISOBUS UT Softkey Frame (only in UT Plugin projects)

If the soft key frame should be used by a UT (only for ISO devices and UT plugin projects), this needs to be checked. Note that no soft key levels should be created in that case. Also, the width of the soft key frame should be set to 1 to not have it interfere with the UT softkey touch regions (especially for full screen UT views)

ISOBUS UT First Key Number (only in UT Plugin projects)

A UT page has a certain amount of soft keys, from 0 to x. This property defines what the first UT soft key number should be in this soft key frame (e.g. a 0 means that the first UT soft key (i.e. soft key number 0) should be connected with the first physical soft key on the device. If the device has soft keys on both sides, then one of the soft key frames should have this set to 0 and the other to 0+<number of physical soft keys on the device>.

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.