![](http://datasheet.mmic.net.cn/260000/PPSMMANUAL_datasheet_15946768/PPSMMANUAL_92.png)
18-4
Programmer’s Manual
Return Value
18.5
ActiveAreaToFront
Syntax
STATUS
ActiveAreaToFront
(U32 areaId)
Description
Given the active area identifier, this tool will extract the element from the active
area linked list and insert the element at the front of the list.
Once the element is at the front of the list, it becomes the active area to receive
pen input if other active areas that are overlapping the same physical area.
Parameter
Return Value
18.6
ActiveListPop
Syntax
STATUS
ActiveListPop
(void)
flag
Flag to indicate whether to suspend or re-
enable the active area:
AREA_SUSPEND
Suspend the active area
AREA_REENABLE
Re-enable the active area
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_AREA_ID
Invalid active area identifier
Name
Description
areaId
Active area identifier. Must be a valid
identifier returned by PPSM
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_AREA_ID
Invalid active area identifier
Name
Description
Personal Portable System Manager
Programmer’s Manual
Pen Input TPen Input Tools
18-5
Description
Pops the top background active list of the current task from the active area
stack. The active list that is currently being used is destroyed, replaced by the
top background active list.
Parameter
Return Value
18.7
ActiveListPush
Syntax
STATUS
ActiveListPush
Description
Pushes the current active area list of the current task into background and
creates a new empty active area list. Once in the background, scanning on
these areas is disabled. Any new active areas registering to PPSM will belong
to the new active list.
The number of active lists in the background is restricted to 8 levels. They are
stored internally in an active area stack.
Parameter
Return Value
Name
Description
None
Name
Description
PPSM_OK
Successful operation
PPSM_ERROR
Active list stack empty
Name
Description
None
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_ACTIVE_PUSH
Unable to push active list
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.