19-4
CharaCharacter Input Tools
Programmer’s Manual
STATUS
CloseInputPad
(void)
Description
Closes the handwritten character input pad.
The input pad image is removed from the panning screen display and no more
handwriting recognition messages (IRPT_HWR) will be generated from the
system to the application. The original image covered by the input pSyntax
restored by the system.
Parameter
Return Value
19.4
CloseSoftKey
Syntax
STATUS
CloseSoftKey
(void)
Description
Closes the soft keyboard module.
The soft keyboard image is removed from the display area and no more key
pressed messages (IRPT_KEY) will be generated from the system to the
application. The original image covered by the keyboard is restored by the
system.
Parameter
Return Value
Name
Description
None
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_PEN_INIT
No active area found
PPSM_ERR_INPUT_PAD_CLOSED
Input pad is not opened
Name
Description
None
Name
Description
PPSM_OK
Successful operation
Personal Portable System Manager
Programmer’s Manual
19-5
STATUS
OpenInputPad
U16 areaSize
,
Description
Opens the input pad for handwritten character input.
The input pad is drawn at the specified position in a row by column format. The
input pad has numRow
number of square input boxes. Each input
box is of size areaSize
pixels.
Once the input pad is opened, handwriting recognition interrupt messages
(IRPT_HWR) are generated to the application when characters are being
recognized. Each recognized character generates an individual interrupt
message.
Only one input pad is allowed among all applications. The image that is
covered by the input pad is saved by the system automatically, which will be
restored upon closing of the input pad. Note that the image saved by the
system is a snap-shot of the display screen at the time this tool is called. Any
changes to this area by the application will not be recorded by the system. The
input pad needs to be closed before any of the other applications can open it.
The default length of input timeout is 1sec.
Parameter
Return Value
PPSM_ERROR
Soft keyboard is not opened
Name
Description
xPos
yPos
numRow
numCol
areaSize
Name
Description
PPSM_OK
Successful operation
Name
Description
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.