g4p_controls.GTabManager Class Reference

Public Member Functions
boolean	addControl (Focusable control)
boolean	addControls (Focusable... controls)
boolean	removeControl (Focusable control)

Detailed Description

Allows TABBING between text controls. A tab manager allows the user to use the TAB key to move from one text control (GTextField or GTextArea) to the another. This is useful when creating a 'form' made from several text controls.
The tab order is decided by the order the text controls are added to the tab manager. The TAB key move the focus forwards and SHIFT+TAB moves it backwards. Note that tabbing is not cyclic so pressing TAB on the last control does not set the focus on the first control, in fact it will be ignored. Similar logic applies to SHIFT_TAB on the first control
At least 2 controls must be added to the tab manager.

Author

Peter Lager

Member Function Documentation

addControl()

boolean g4p_controls.GTabManager.addControl

(

Focusable

control

)

Add the next text control to this tab manager.

Parameters

control

to add

Returns

true if added successfully

addControls()

boolean g4p_controls.GTabManager.addControls

(

Focusable...

controls

)

Attempt to add multiple controls to the tab manager. The tab order is determined by their order as parameters to this method.

Parameters

controls

a comma separated list of text field or text area controls.

Returns

true if any or all of the controls were added and false if none were added.

removeControl()

boolean g4p_controls.GTabManager.removeControl

(

Focusable

control

)

Remove a control from the tab manager. This does not affect the tab order of the remaining controls.

Parameters

control

the control to remove from this tab manager

Returns

true if removed, else false