
CHAPTER 21
Routing Interface
21-28 Using Routing
entry and even some of the slots from the soup entry. Note that you must use name
references; you cannot specify soup entries directly.
To create a name reference object, use name reference data definitions registered
with the system in the data definition registry. There are built-in name reference
data definitions for e-mail (
'|nameRef.email|), fax ('|nameRef.fax|), and
call (
'|nameRef.phone|) information associated with names from the Names
file. These data definitions contain a method,
MakeNameRef, that creates and
returns a name reference.
You can pass a Names soup entry directly to
MakeNameRef, or you can construct
your own simple frame of information that contains the appropriate slots. Fax and
call name references should include the slots
name, phone, and country. E-mail
name references should include the slots
name, email, and country. For more
information about these slots, see “Names Soup Format” (page 16-15) in Newton
Programmer’s Reference.
Here’s an example of how to create a name reference for a fax phone number or an
e-mail address:
// use a Names file entry directly
local myData := aNamesFileEntry; // entry from Names soup
// or create your own fake entry frame based on other info
local myData := {
name:{first:"Juneau", last:"Macbeth"},
phone: "408-555-1234", // fax phone string
country: "USA",
}
// then create the fax name reference
aToRef := GetDataDefs('|nameRef.fax|):MakeNameRef(myData,
'|nameRef.fax|);
// or create the e-mail name reference
aToRef := GetDataDefs('|nameRef.email|):MakeNameRef(myData,
'|nameRef.email|);
For more information about name references and the MakeNameRef method, see
the documentation of
protoListPicker in Chapter 6, “Pickers, Pop-up Views,
and Overviews.”
Specifying a Printer 21
For print operations, the printer slot of the item frame specifies which printer to
use. This slot must contain a printer frame. The only valid way of obtaining a
printer frame is from the
currentPrinter variable of the user configuration
Comentarios a estos manuales