Updated: June 1, 2006 - Added sample application
Description:
FormNavHelper provides functions for handling the Treo-style focus
ring form navigation system on newer Palm handhelds. Functions
include:
HasFormNav - Returns whether this device has form nav support.
USAGE: hasnav = HasFormNav()
Return values are:
0 - form navigation not supported on this device
1 - V1 form navigation support (Treo600)
2 - V2 form navigation support (Treo650, T5, TE2, LD, TX,
Z22, etc.)
GetNavState - Returns current form navigation state.
USAGE: navstate = GetNavState()
Return values are:
0 - form navigation disabled
1 - Application Focus Mode - app must handle all form nav
itself (like disabled)
2 - Object Focus Mode - system automatic 5-way form navigation
mode (focus rings active)
3 - Field Edit Mode - form nav enabled but edit field
currently has focus (focus ring not shown)
SetNavState - Sets current form navigation state.
USAGE: SetNavState( navstate )
Use state value as explained above in GetNavState
GetNavControlFocus - Gets the index of the control on the current
form that has navigation focus.
USAGE: indexstr = GetNavControlFocus()
NOTE: The control index is returned in the format Cnnn which
differs from the string returned by the control.index value
(which is %Fnnn.Cnnn). Use the Right string operator to
compare this index to a control index,
eg: indexstr = GetNavControlFocus()
If indexstr = Right(control1.index, 4) then
SetNavControlFocus - Sets current form navigation focus on
specified form object.
USAGE: SetNavControlFocus( control.index )
Installation:
Copy the files in the zip file to these locations in your Satellite Forms 6.1 program folder:
FormNavHelper.inf ---> \Satellite Forms 6.1\Extensions\Standard
SFE_FormNavHelper.prc ---> \Satellite Forms 6.1\Extensions\Standard\Palm
FormNavHelper.sfa ---> \Satellite Forms 6.1\Samples\Projects\FormNavHelper (create this folder)
Remember to download the extension prc file to your Palm device as well.
