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

9    Keyboard

Input Services

Exploring Palm OS®

The chapter describes the API declared in the header file Keyboard.h.

Keyboard Functions and Macros ^TOP^

SysKeyboardDialog Function ^TOP^

Purpose

Pops up the system keyboard if there is a field object with the focus.

Declared In

Keyboard.h

Prototype

void SysKeyboardDialog (
   KeyboardType kbd
)

Parameters

kbd
One of the following:
kbdAlpha
Show alphabetic characters.
kbdNumbersAndPunc
Show numbers and some advanced punctuation.
kbdAccent
The International character set, made up of Latin characters with diacritic marks.
kbdDefault
Same as kbdAlpha.

Returns

Nothing.

Comments

On devices with a dynamic input area, this function switches the currently active pinlet to the default keyboard style pinlet.

On devices with a static input area (one that is silkscreened onto the device), this function displays a keyboard dialog with a text field and keyboard. The current text field's handle is reassigned to the keyboard dialog's text handle while the dialog is active.