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 /

BlockKeyCommand

view:BlockKeyCommand(keyMessageSymbol)

Hides a key command that would ordinarily be accessible in the view.

keyMessageSymbol

A symbol that names the command message. This must be the same message as you specified in the keyMessage slot of the keyCommand frame.

return value

Undefined; do not rely on it.

DISCUSSION

The *BlockKeyCommand method makes any key command that matches keyMessageSymbol unavailable from the view. The key command no longer appears on the command key popup help slip in the view.

IMPORTANT

The *AddKeyCommand and *BlockKeyCommand methods grow a RAM-based array, so you must be careful to not overuse these methods.