Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Chapter 4 - Keyboard Enhancements

Summary of Keyboard Enhancements

Data Structures

Command-Key MappingFrame

 {

char:       char,          // unmodified keypress character
modifiers:  int,           // modifiers
keyMesage:  symbol,        // message to send for key-command
name:       string,        // command name for menus
category:   string,        // command category
showChar:   char,          // char to display in menus
}

Methods and Functions

    // Posts key events as if they were typed on a hardware keyboard

HandleKeyEvents(keyEvents)

    // Determines if the keystroke is a command-key combination.

IsCommandKeystroke(char, flags)

    // Determines if a key is down

IsKeyDown(keyCode, isHardKeyboard)

    // Associates key-command with view

view:AddKeyCommand(keyCommandFrame)

    // Associates an array of key-commands with a view

view:AddKeyCommands(arrayOfKeyCommandFrames)

    // Hides a key-command in a view

view:BlockKeyCommand(keyMessageSymbol)

    // Categorizes an array of key-command frames

CategorizeKeyCommands(keyCommandArray)

    // Removes all key-commands from a view

view:ClearKeyCommands()

    // Finds key-command that matches key combination

FindKeyCommand(startView, char, flags)

    // Returns array of all key commands in a view

GatherKeyCommands(startView)

    // Causes a button to act as if it was tapped

PressButton(buttonView)

    // Sends a message to a view as if the user typed a key-command

SendKeyMessage(keyView, keyMessage)

    // Sent to view when user presses down on key

view:ViewKeyDownScript(char, flags)

    // Sent to view when user releases a key

view:ViewKeyUpScript(char, flags)

    // Sent repeatedly to view while user holds a key down

view:ViewKeyRepeatScript(char, flags)

    // Sent to view when a batch of keystrokes needs processing

view:ViewKeyStringScript(string)

---

Subtopics

Data Structures

Command-Key MappingFrame

Methods and Functions