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

Chapter 4 - Keyboard Enhancements / Keyboard Reference

Methods and Functions for Handling Command Keys /

FindKeyCommand

FindKeyCommand(startView, char, flags)

Searches for and returns the key command frame that matches a key combination.

startView

The view in which to start searching for the command key.

char

The command key character. Note that if a modifier key is the only key pressed (for example, the Shift key), this value will be 0.

flags

A 30-bit integer that specifies which modifier keys were pressed and other additional information. The use of the individual bits in this value are shown in Table 4-14.

return value

The matching keyCommand or nil if none is found.

DISCUSSION

The *FindKeyCommand function starts at the view startView and looks for a keyCommand frame that matches the keypress described by char and flags.