Apple Newton Utilities User's Guide download pdf (Page 522)

100

101

CHAPTER 12

Special-Purpose Objects for Data Storage and Retrieval

12-16 Using Special-Purpose Data Storage Objects

Testing the Validity of a Mock Entry 12

The IsMockEntry global function returns the value true for objects that are valid

mock entries. You can use this function to distinguish between mock entry objects

and other objects such as cache frames or soup entries. Note that the

IsSoupEntry

function returns

true for both mock entries and normal soup entries.

Getting Mock Entry Data 12

The EntryCachedObject global function returns the cached frame associated

with a speciﬁed mock entry. You can call this function to retrieve the cached frame

associated with a speciﬁed mock entry. For example, your handler frame’s

EntryChange method must retrieve the cached frame in order to write it back to

a mock soup.

Changing the Mock Entry’s Handler 12

The EntrySetHandler function is a special-purpose function that you can use to

replace a mock entry’s handler. For example, you can use this function to install a

handler that implements debug versions of methods present in the mock entry’s

original handler frame. Such methods might include breakpoints and print

statements that would not be present in the commercial version of an application.

Getting the Mock Entry’s Handler 12

The system supplies the EntryHandler function for debugging purposes. The

EntryHandler function returns a reference to the handler frame associated with

the mock entry speciﬁed by the value of the

mockEntry parameter.

Implementing Additional Handler Methods 12

Your handler needs to provide additional methods that are the mock entry counter-

parts to system-supplied entry functions, such as

EntryUndoChangesXmit, and

others. For a list of suggested methods that your handler may implement, see

“Application-Deﬁned Mock Entry Handler Methods” on page 12-19.

1 2 ... 517 518 519 520 521 522 523 524 525 526 527 ... 941 942

Comments to this Manuals

No comments

Apple Newton Utilities User's Guide Page 522

Comments to this Manuals

Related products and manuals for Software Apple Newton Utilities