Widgets

Label

Labels are static text that can't interact with the user and can't be changed by the application at run-time either. For non-static labels, use a non-editable text field.

Properties

Resource ID

A unique string ID used for accessing the resource at run-time from the program

Usable

Non-usable widgets are not rendered on the screen and don't receive events. You can set/unset the "usable" property at run-time with the CtlSetUsable function.

Text and font

The textual contents of the widget. It will be rendered using the specified font.

Guikachu currently only supports the three default built-in fonts: #0 is the "normal", #1 is the "bold" and #2 is the "large" font.

X and Y

Horizontal and vertical position relative to the parent form, in pixels, counted from left to right and top to bottom. Due to the size of the screen of PalmOS devices, both X and Y are integer values between 0 and 159.

Text field

WRITE ME

Properties

Resource ID

A unique string ID used for accessing the resource at run-time from the program

Usable

Non-usable widgets are not rendered on the screen and don't receive events. You can set/unset the "usable" property at run-time with the CtlSetUsable function.

Font

The font used to display the contents of the text field

Guikachu currently only supports the three default built-in fonts: #0 is the "normal", #1 is the "bold" and #2 is the "large" font.

Editable

WRITE ME

Multi-line

WRITE ME

Numeric-only

WRITE ME

Maximum length

Maximum allowed length of text entered by the user. Set this to 0 to force no restrictions (actually, there is still a restriction on length due to the PalmOS architecture).

Underlined

WRITE ME

Auto-shift

If you set this property, the graffiti shift state will behave "smartly", e.g. shift will be turned on for new sentences.

Dynamic size

WRITE ME

Scrollbar

Set this to have a scrollbar on the right-hand side of the text field when the contents are larger than the size of the widget.

The scrolling itself will be automatically done by the OS, you don't need to do anything on your own.

X and Y

Horizontal and vertical position relative to the parent form, in pixels, counted from left to right and top to bottom. Due to the size of the screen of PalmOS devices, both X and Y are integer values between 0 and 159.

Width and height

Horizontal and vertical size, in pixels. Due to the size of the screen of PalmOS devices, both width and height are integer values between 1 and 160.

You can also use automatic values calculated from the size of the widget's contents.

Graffiti State Indicator

This widget displays an icon showing the current state (like upper-case input, or punctuation marks) of the Graffiti input system. It is automatically connected to the input system, so you don't have to bother implementing it. Just place it on a form and you're set.

Properties

Resource ID

A unique string ID used for accessing the resource at run-time from the program

X and Y

Horizontal and vertical position relative to the parent form, in pixels, counted from left to right and top to bottom. Due to the size of the screen of PalmOS devices, both X and Y are integer values between 0 and 159.

Button

A button is a (rounded) rectangular user interface element that emits a specific signal to the application when the user taps it with the stylus.

Properties

Resource ID

A unique string ID used for accessing the resource at run-time from the program

Usable

Non-usable widgets are not rendered on the screen and don't receive events. You can set/unset the "usable" property at run-time with the CtlSetUsable function.

Text and font

The textual contents of the widget. It will be rendered using the specified font.

Guikachu currently only supports the three default built-in fonts: #0 is the "normal", #1 is the "bold" and #2 is the "large" font.

Frame type

Buttons can optionally have one of two types of frame around them. It is usually a good idea to give buttons a frame as this helps users distinguishing it from a simple label

Repeating

Repeating buttons emit several ButtonPress signals when kept pressed by the user.

Anchor right

If the widget's size changes at run-time and this flag is set, the new horizontal position is calculated to leave the widget's right edge at place.

X and Y

Horizontal and vertical position relative to the parent form, in pixels, counted from left to right and top to bottom. Due to the size of the screen of PalmOS devices, both X and Y are integer values between 0 and 159.

Width and height

Horizontal and vertical size, in pixels. Due to the size of the screen of PalmOS devices, both width and height are integer values between 1 and 160.

You can also use automatic values calculated from the size of the widget's contents.

Check box

A check box contains a state icon and a text label. The state icon shows wether the widget is "checked", this state can then be handled by the application via the CtlGetValue function.

Properties

Resource ID

A unique string ID used for accessing the resource at run-time from the program

Usable

Non-usable widgets are not rendered on the screen and don't receive events. You can set/unset the "usable" property at run-time with the CtlSetUsable function.

Text and font

The textual contents of the widget. It will be rendered using the specified font.

Guikachu currently only supports the three default built-in fonts: #0 is the "normal", #1 is the "bold" and #2 is the "large" font.

Toggled

Initial checked/unchecked state of the widget

Group ID

If a check box or pushbutton belongs to a group, only one per group can be checked by the user. This is automatically enforced by PalmOS. Note that check boxes and pushbuttons share their groups.

Set the group ID to 0 if you don't want to include it in any group.

Anchor right

If the widget's size changes at run-time and this flag is set, the new horizontal position is calculated to leave the widget's right edge at place.

X and Y

Horizontal and vertical position relative to the parent form, in pixels, counted from left to right and top to bottom. Due to the size of the screen of PalmOS devices, both X and Y are integer values between 0 and 159.

Width and height

Horizontal and vertical size, in pixels. Due to the size of the screen of PalmOS devices, both width and height are integer values between 1 and 160.

You can also use automatic values calculated from the size of the widget's contents.

Pushbutton

A pushbutton behaves a lot like a check box, except it has no initial state and is rendered as a rectangular button.

Properties

Resource ID

A unique string ID used for accessing the resource at run-time from the program

Usable

Non-usable widgets are not rendered on the screen and don't receive events. You can set/unset the "usable" property at run-time with the CtlSetUsable function.

Text and font

The textual contents of the widget. It will be rendered using the specified font.

Guikachu currently only supports the three default built-in fonts: #0 is the "normal", #1 is the "bold" and #2 is the "large" font.

Group ID

If a check box or pushbutton belongs to a group, only one per group can be checked by the user. This is automatically enforced by PalmOS. Note that check boxes and pushbuttons share their groups.

Set the group ID to 0 if you don't want to include it in any group.

X and Y

Horizontal and vertical position relative to the parent form, in pixels, counted from left to right and top to bottom. Due to the size of the screen of PalmOS devices, both X and Y are integer values between 0 and 159.

Width and height

Horizontal and vertical size, in pixels. Due to the size of the screen of PalmOS devices, both width and height are integer values between 1 and 160.

You can also use automatic values calculated from the size of the widget's contents.

Selector trigger

WRITE ME

Properties

Resource ID

A unique string ID used for accessing the resource at run-time from the program

Usable

Non-usable widgets are not rendered on the screen and don't receive events. You can set/unset the "usable" property at run-time with the CtlSetUsable function.

Text and font

The textual contents of the widget. It will be rendered using the specified font.

Guikachu currently only supports the three default built-in fonts: #0 is the "normal", #1 is the "bold" and #2 is the "large" font.

Anchor right

If the widget's size changes at run-time and this flag is set, the new horizontal position is calculated to leave the widget's right edge at place.

X and Y

Horizontal and vertical position relative to the parent form, in pixels, counted from left to right and top to bottom. Due to the size of the screen of PalmOS devices, both X and Y are integer values between 0 and 159.

Width and height

Horizontal and vertical size, in pixels. Due to the size of the screen of PalmOS devices, both width and height are integer values between 1 and 160.

You can also use automatic values calculated from the size of the widget's contents.

Popup trigger

WRITE ME

Properties

Resource ID

A unique string ID used for accessing the resource at run-time from the program

Usable

Non-usable widgets are not rendered on the screen and don't receive events. You can set/unset the "usable" property at run-time with the CtlSetUsable function.

Text and font

The textual contents of the widget. It will be rendered using the specified font.

Guikachu currently only supports the three default built-in fonts: #0 is the "normal", #1 is the "bold" and #2 is the "large" font.

List ID

WRITE ME

Anchor right

If the widget's size changes at run-time and this flag is set, the new horizontal position is calculated to leave the widget's right edge at place.

X and Y

Horizontal and vertical position relative to the parent form, in pixels, counted from left to right and top to bottom. Due to the size of the screen of PalmOS devices, both X and Y are integer values between 0 and 159.

Width and height

Horizontal and vertical size, in pixels. Due to the size of the screen of PalmOS devices, both width and height are integer values between 1 and 160.

You can also use automatic values calculated from the size of the widget's contents.

Scroll bar

WRITE ME

Properties

Resource ID

A unique string ID used for accessing the resource at run-time from the program

Usable

Non-usable widgets are not rendered on the screen and don't receive events. You can set/unset the "usable" property at run-time with the CtlSetUsable function.

Value interval

WRITE ME

Initial value

WRITE ME

Page size

WRITE ME

X and Y

Horizontal and vertical position relative to the parent form, in pixels, counted from left to right and top to bottom. Due to the size of the screen of PalmOS devices, both X and Y are integer values between 0 and 159.

Width and height

Horizontal and vertical size, in pixels. Due to the size of the screen of PalmOS devices, both width and height are integer values between 1 and 160.

You can also use automatic values calculated from the size of the widget's contents.

List

WRITE ME

Properties

Resource ID

A unique string ID used for accessing the resource at run-time from the program

Usable

Non-usable widgets are not rendered on the screen and don't receive events. You can set/unset the "usable" property at run-time with the CtlSetUsable function.

Visible items

WRITE ME

Font

The font used to display the list items

Guikachu currently only supports the three default built-in fonts: #0 is the "normal", #1 is the "bold" and #2 is the "large" font.

X and Y

Horizontal and vertical position relative to the parent form, in pixels, counted from left to right and top to bottom. Due to the size of the screen of PalmOS devices, both X and Y are integer values between 0 and 159.

Width

Horizontal size, in pixels. Due to the size of the screen of PalmOS devices, this is an integer value between 1 and 160.

You can also use an automatic value calculated from the width of the first list item.

The height of the widget will be automatically calculated from the number of visible items and the font used.

Gadget

Gadgets are placeholders for widgets implemented by the app author. The application is responsible for rendering the widget and maintaining any associated state data.

Properties

Resource ID

A unique string ID used for accessing the resource at run-time from the program

Usable

Non-usable widgets are not rendered on the screen and don't receive events. You can set/unset the "usable" property at run-time with the CtlSetUsable function.

X and Y

Horizontal and vertical position relative to the parent form, in pixels, counted from left to right and top to bottom. Due to the size of the screen of PalmOS devices, both X and Y are integer values between 0 and 159.

Width and height

Horizontal and vertical size, in pixels. Due to the size of the screen of PalmOS devices, both width and height are integer values between 1 and 160.


Index