background image
C H A P T E R 2 1
Routing Interface
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 (
), fax (
), and
call (
) information associated with names from the Names
file. These data definitions contain a method,
, that creates and
returns a name reference.
You can pass a Names soup entry directly to
, or you can construct
your own simple frame of information that contains the appropriate slots. Fax and
call name references should include the slots
, and
. E-mail
name references should include the slots
, and
. 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
email: "", // e-mail address string
country: "USA",
// then create the fax name reference
aToRef := GetDataDefs('|nameRef.fax|):MakeNameRef(myData,
// or create the e-mail name reference
aToRef := GetDataDefs('||):MakeNameRef(myData,
For more information about name references and the
method, see
the documentation of
in Chapter 6, "Pickers, Pop-up Views,
and Overviews."
Specifying a Printer
For print operations, the
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
variable of the user configuration
© 2007-2017, o7 studio » при воспроизведении материала сайта ссылка обязательна