This chapter provides reference material for the shift indicator API, declared in the header file GraffitiShift.h
.
GraffitiShift Functions
GsiEnable Function
Purpose
Enable or disable the shift indicator.
Declared In
GraffitiShift.h
Prototype
void GsiEnable ( const Boolean enableIt )
Parameters
Returns
Comments
Enabling the indicator makes it visible, disabling it makes the insertion point invisible.
GsiEnabled Function
Purpose
Return true
if the shift indicator is enabled, or false
if it's disabled.
Declared In
GraffitiShift.h
Prototype
Boolean GsiEnabled ( void )
Parameters
Returns
true
if enabled, false
if not.
GsiInitialize Function
Purpose
Initialize the global variables used to manage the shift indicator.
Declared In
GraffitiShift.h
Prototype
void GsiInitialize ( void )
Parameters
Returns
GsiSetLocation Function
Purpose
Set the display-relative position of the shift indicator.
Declared In
GraffitiShift.h
Prototype
void GsiSetLocation ( const Int16 x, const Int16 y )
Parameters
Returns
Comments
The indicator is not redrawn by this routine.
Do not use this function in application code. It is used internally by the Form Manager. If you need to change the shift indicator's location to support devices with a dynamic input area, see knowledge base article 507 for sample code that shows you how to do so.
GsiSetShiftState Function
Purpose
Declared In
GraffitiShift.h
Prototype
void GsiSetShiftState ( const UInt16 lockFlags, const UInt16 tempShift )
Parameters
Returns
Comments
This function affects only the state of the UI element, not the underlying Graffiti® or Graffiti 2 engine.