Flag-naming conventions 9 – Apple Newton Programmer’s Newton 2.0 (for Newton 2.0) User Manual

Page 361

Advertising
background image

C H A P T E R 9

Recognition

About the Recognition System

9-19

displays a picker from which the user can choose recognition behaviors that you
specify. When this picker is collapsed, the appearance of the button indicates the
current recognition settings for the view or views that it controls. Figure 9-8 shows
the appearance of typical

protoRecToggle

view when it is collapsed and when

it is expanded to display the pick list of recognizers it can enable.

Figure 9-8

Use of

protoRecToggle

view in the Notes application

The default picker provides all of the items shown in Figure 9-8 in the order
illustrated. You can specify that this picker display a subset of these items in the
order you specify.

The topmost item in the picker indicates the recognizer that the

recToggle

view

enables by default; unless you specify otherwise, the

recToggle

view enables the

text recognizer by default, as shown in the figure.

You can also provide code that restores the user’s most recent

recToggle

setting

or initializes the

recToggle

to a predetermined setting each time your

application opens.

The picker’s Preferences item opens the Handwriting Recognition user preferences
slip by default.

For more information on

protoRecToggle

views, see Chapter 10, “Recognition:

Advanced Topics,” as well as the description of this prototype in

Newton

Programmer’s Reference

.

Flag-Naming Conventions

9

This section describes conventions used to name recognition-related view flags, as
well as the significance of the use of the words

Field

and

Allowed

in flag names.

The Entry Flags area of the Newton Toolkit (NTK) view editor actually sets view
flags. The distinction that Newton Toolkit makes between “view flags” and “entry
flags” is an artifact of the way certain views create child views dynamically at
run time.

For example, when the user taps a

protoLabelInputLine

view, it creates and

opens a

clParagraphView

child that is the input line view in which text

Collapsed

Expanded

Advertising