Documentation  |   Table of Contents   |  < Previous   |  Next >  

86    PenInputMgr.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

The Pen Input Manager controls how an application interacts with a dynamic input area. In Palm OS Cobalt, the dynamic input area runs a separate thread called a pinlet. Because of this change and because of changes to the Window Manager, applications work with the input area differently than they did previously.

  • Most applications can become dynamic input area aware just by defining size constraints. You can now do so using a WINDOW_CONSTRAINTS_RESOURCE in the resource file rather than calling WinSetConstraintsSize().
    • FrmSetDIAPolicyAttr() is obsolete. All forms with size constraints are dynamic input area aware.
    • Setting the input area state to pinInputAreaUser is no longer necessary. This default state is always in effect unless the application specifically overrides it.
    • Applications are no longer allowed to disable the input trigger.
  • The form's window is resized for you as the input area is opened and closed. The application receives a winResizedEvent with the new bounds for the form. The Form Manager defines a FrmPerformLayout() function that can handle the rearranging of many user interface elements automatically based on rules you specify when the form is loaded. See Exploring Palm OS: User Interface for more information.
  • The Pen Input Manager defines new functions that allow the application to control the pinlet; however, most applications will not need to use these functions. Users should decide which pinlet they want to use, just as they decide whether they want the input area opened or closed.

Deleted APIs ^TOP^

Table 86.1  Deleted functions

Deleted API

Use instead

PINGetInputTriggerState()

The input area trigger is always enabled unless the current application is a legacy application.

PINSetInputTriggerState()

Table 86.2  Deleted enumerated types

Deleted API

Use instead

PINInputAreaStateType

The input area states are now #defines. pinInputAreaUser has been removed because it is no longer necessary. Palm OS Cobalt always uses the last user state of the input area unless the application specifically overrides it. Other constants that were system use only have also been removed.

PINInputTriggerStateType

Applications are no longer allowed to control the input trigger state.

Unchanged APIs ^TOP^

Table 86.3  Unchanged functions

PINGetInputAreaState()

PINSetInputAreaState()

StatHide()

StatShow()

Table 86.4  Unchanged #defines 

pinAPIVersion1_0

pinAPIVersion1_1

pinAPIVersion2_0

pinCreator

pinErrInvalidParam

pinErrNoSoftInputArea

pinFtrAPIVersion