![](http://datasheet.mmic.net.cn/260000/PPSMMANUAL_datasheet_15946768/PPSMMANUAL_99.png)
19-6
CharaCharacter Input Tools
Programmer’s Manual
19.6
OpenSoftKey
Syntax
STATUS
OpenSoftKey
(U16 xPos U16 yPos)
Description
Opens a soft keyboard module for type-written English character input.
A soft keyboard is drawn at the position specified by the application. Once the
keyboard is opened, key-pressed interrupt messages (IRPT_KEY) are
generated to the application when key icons on the soft keyboard module are
pressed. Each individual key pressed generates an individual interrupt
message.
Only one soft keyboard is allowed for each application. The image thReturn Value
covered by the pseudo keyboard is saved by the system automatically, which
will be restored upon closing of the keyboard. 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.
Parameter
Return Value
PPSM_ERR_INPUT_PAD_OPENED
Input pad already opened by the same
task or its sibling sub-task or its parent
task
PPSM_ERR_INPUT_PAD_X_POS
Input pad x-coordinate out of range
PPSM_ERR_INPUT_PAD_Y_POS
Input pad y-coordinate out of range
PPSM_ERR_INPUT_PAD_WIDTH
Input pad width out of range
PPSM_ERR_INPUT_PAD_HEIGHT
Input pad height out of range
PPSM_ERR_NO_MEMORY
Not enough memory
Name
Description
xPos
X-coordinate of the top left corner of the
soft keyboard
yPos
Y-coordinate of the top left corner of the
soft keyboard
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_SKBD_X_POS
Input pad x-coordinate out of range
Name
Description
Personal Portable System Manager
Programmer’s Manual
19-3
width and height of each key in number of pixels
number of rows and columns of keys
the return code of each key(ie, key code or scan code)
the bitmap of the soft keyboard user interface
Parameter
19.3
CloseInputPad
Syntax
Name
Description
xPos
X-coordinate of the top left corner of the
soft keyboard
yPos
Y-coordinate of the top left corner of the
soft keyboard
keyWidth
Width of each key in number of pixels
keyHeight
Height of each key in number of pixels
numRow
Number of rows of keys
numCol
Number of columns of keys
keyMap
Pointer to an array of return key codes,
from the top left key towards to the right,
then next row and so on, until the bottom
right key
bitmap
bitmap of the soft keyboard area interface
width = (keyWidth * numCol)
height = (keyHeight * numRow)
in number of pixels
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_SKBD_USED
Soft keyboard has already being used by
current task
PPSM_ERR_PAN_INIT
Panning screen info is not initialized yet
PPSM_ERR_INPUT_PAD_NOSCRE
EN
No panning screen memory is allocated
for this task
PPSM_ERR_SKBD_XSIZE
Soft keyboard x-coordinate out of range
PPSM_ERR_SKBD_YSIZE
Soft keyboard y-coordinate out of range
PPSM_ERR_NO_MEMORY
Not enough memory
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.