NeoCal Documentation

NeoCal for Palm OS User Guide

Dynamic Keyboards

The keyboards are constructed dynamically to best take advantage of the available screen space while maintaining efficient operation based on user preferences which are specified by the current theme and possibly overridden by options in the Preferences dialog.

Several different sets of glyphs are available for drawing the keys and NeoCal will always select the largest glyph for any given key. In other words, the bigger the key, the bigger the writing on it and the smaller the key, the smaller the writing. If the key is large enough, NeoCal can display both the primary and shifted functions at the same time. The appearance and behavior of the keyboard is controlled by a number of settings:

The Show option determines whether the shifted functions should be shown along with the primary functions and, if so, where they should be displayed. None specifies they should never be shown even when there is plenty of room, Above specifies the shifted functions should be displayed above and outside the key boundaries, and Within specifies the shifted functions should be drawn on the face of the key (above the primary function). If there is not enough room to display all of the shifted functions, none of them will be displayed regardless of the current setting. To increase the likelihood that shifted functions will be shown, try reducing the border, font size, and/or number of display lines.

If the shifted functions should be shown but there is not enough room to display them, NeoCal may change the primary function glyph to a smaller size to provide the room necessary to display the shifted functions. In this case, the Size option specifies the smallest acceptable size for the primary functions.

The Keys option specifies how the shifted keyboards should be displayed when the shifted functions are shown on the primary keyboard. The Static setting will not display a separate shifted keyboard, but continue to display the primary keyboard when the shift state is active. The Swapped setting switches the shifted function with the primary function indicating the lower (shifted) function is active and pressing the shift button again will access the primary function. The Zoomed setting will display keys with only the active (shifted) function visible. If the shifted functions are not displayed on the primary keyboard, then the shifted keyboards will be displayed with the equivalent of the Zoomed setting.

The Color option specifies which color to use when drawing the shifted function on the primary keyboard. Shift indicates the shift color should be used, overridding the foreground color for that particular key. Foreground indicates the normal glyph color for that key should be used. Background causes the glyph to be drawn using the background color for that function. If the shifted functions are displayed within the key and this setting is set to Background, the glyph will be drawn using the shift color.

The Highlight option specifies which color should be used for displaying the shifted (active) function on the shifted keyboard. The Shift setting specifies the glyph should be drawn using the shift color and the Foreground setting specifies the normal color used for drawing that function. The Swapped setting will draw the shifted function using the foreground color of the primary function, and draw the primary function using the shift color.