LTabGroup

LTabGroup is a PowerPlant class that is used for managing tab key navigation between two or more edit fields in a view. Mac OS Human Interface Guidelines suggest that typing the Tab key should advance the text entry cursor from one field to the next.

Methods :

The methods in this class are:

LTabGroup()	~LTabGroup()
BeTarget()	GetOnDutySub()
HandleKeyPress()	RotateTarget()

Data Members:

There are no data members is this class.

Operation:

A Tab Group switches the Target amongst its SubCommanders in response to Tab and Shift-Tab key presses. A SubCommander is responsible for passing up Tab key presses to its SuperCommander if it wants to be usuable with a TabGroup.

By default, the first SubCommander of a TabGroup will be the Target when the Window containing the TabGroup is activated. If there is more than one TabGroup in a Window, then the last TabGroup will be the one on duty.

To make a particular Commander be the Target when its Window is activated, callSetLatentSub() for that LCommander.

Source files:

(Support Classes)

LTabGroup.h

LTabGroup.cp

Ancestors:

LAttachable

LCommander

LTabGroup()

Purpose:

The constructor creates objects from the passed-in parameters.

Access:

Public

Prototype:

LTabGroup();

LTabGroup( LStream* inStream );

LTabGroup( LCommander *inStream );

The parameters for these constructors are:

LStream*	inStream	This is unused.
LCommander*	inSuper	Pointer to the SuperCommander.

~LTabGroup()

Purpose:

The destructor destroys the object.

Access:

Virtual, Public

Prototype:

virtual ~LTabGroup();

BeTarget()

Purpose:

TabGroup has become the Target. This is an override of BeTarget() in LCommander.

GetOnDutySub()

Purpose:

Return the on duty SubCommander of a TabGroup.

Access:

Virtual, Protected

Prototype:

virtual LCommander* GetOnDutySub();

None

Return:

A pointer to the LCommander on duty.

HandleKeyPress()

Purpose:

Tab switches the Target to the next item in the TabGroup. Shift-Tab to the previous item.

All other keystrokes (and Tabs with modifiers other than Shift) get passed up. This is an override of HandleKeyPress() in LCommander.

RotateTarget()

Purpose:

Switch Target to another SubCommander, either the one before or after the current one.

Access:

Virtual, Public

Prototype:

virtual void RotateTarget( Boolean inBackward );

The parameters for these constructors are:

Boolean

inBackward

This indicates whether to rotate backward or forward in the sequence.

Return:

None