Documentation  |   Table of Contents   |  < Previous   |  Next >   |  Index

Table of Contents

Input Services

Exploring Palm OS®

About This Document

Who Should Read This Book

What This Book Contains

Changes to This Book

The Exploring Palm OS Series

Additional Resources

Part I: Concepts

1 Receiving Input

Pen Taps

Input Area

Hardware Controls

2 Working with the Dynamic Input Area

Checking the Dynamic Input Area Features

Programmatically Opening and Closing the Input Area

Interacting with Pinlets

Changing the Active Pinlet

Querying Alternative Input Systems

Setting the Pinlet Input Mode

Summary

3 Customizing the Dynamic Input Area

How Pinlets Work

Building Pinlets and Handwriting Recognition Engines

Starting Up and Shutting Down a Pinlet

Startup

Starting up the Handwriting Recognition Engine

Shutdown

Presenting a User Interface

Main Pinlet Form

Pinlet Style

Internal Pinlet Name

Status Bar Icons and Name

FEP Creator ID

Help Dialog

Input Mode Indicator

Interpreting Pen Strokes

Receiving Pen Events

Sending Results to Pen Input Manager

Considering the Input Modes

Handling Multistroke Characters

Implementing Live Ink

Specifying the Default Pinlet

Guidelines for Default Pinlets

User Interface Considerations

Summary

4 Customizing Hardware Input

Replacing a Built-in Application

Remapping the Hard Keys

Disabling the Hard Keys

Summary

Part II: Reference

5 Low-Level Events Reference

Event Constants

Key Modifier Constants

Events

keyDownEvent

keyHoldEvent

keyHoldEvent5

keyUpEvent

keyUpEvent5

penDownEvent

penMoveEvent

penUpEvent

6 Graffiti 2 Reference

Graffiti 2 Reference Functions and Macros

SysGraffitiReferenceDialog

7 Handwriting Recognition Engine

Handwriting Recognition Engine Structures and Types

CharData

HWRConfig

HWRConfigModeArea

HWRResult

Handwriting Recognition Engine Constants

Ink Hint Constants

Maximum Value Constants

Handwriting Recognition Engine Functions and Macros

HWRClearInputState

HWRGetInputMode

HWRInit

HWRProcessStroke

HWRSetInputMode

HWRShowReferenceDialog

HWRShutdown

HWRTimeout

8 Hard Keys Reference

Hard Key Constants

Key State Values

Key Rate Constants

Hard Key Functions and Macros

KeyCurrentState

KeyRates

KeySetMask

9 Keyboard

Keyboard Functions and Macros

SysKeyboardDialog

10 Pen Input Manager

Pen Input Manager Constants

Default Pinlet Constants

Input Area States

Error Codes

Feature and Version Constants

Input Area Flags Constants

Pinlet Input Modes

Pinlet Information Constants

Pinlet Styles

Virtual Character Flag

Pen Input Manager Launch Codes

sysAppLaunchCmdPinletLaunch

sysPinletLaunchCmdLoadProcPtrs

Pen Input Manager Notifications

sysNotifyAltInputSystemDisabled

sysNotifyAltInputSystemEnabled

Pen Input Manager Functions and Macros

PINAltInputSystemEnabled

PINClearPinletState

PINCountPinlets

PINGetCurrentPinletName

PINGetDefaultPinlet

PINGetInputAreaState

PINGetInputMode

PINGetPinletInfo

PINSetDefaultPinlet

PINSetInputAreaState

PINSetInputMode

PINShowReferenceDialog

PINSwitchToPinlet

11 Pinlet

Pinlet Structures and Types

PinletAPIType

Pinlet Functions and Macros

PINFeedChar

PINFeedString

Pinlet-Defined Functions

PinletClearStateProcPtr

PinletGetInputModeProcPtr

PinletSetInputModeProcPtr

PinletShowReferenceDialogProcPtr

12 Shift Indicator

Shift Indicator Constants

Dimension Constants

GsiShiftState

Lock Flag Constants

Temporary Shift State Constants

Shift Indicator Events

gsiStateChangeEvent

Shift Indicator Functions and Macros

GsiEnable

GsiEnabled

GsiInitialize

GsiSetLocation

GsiSetShiftState