Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Chapter 11 - Miscellaneous

Summary

Data Structures

Views

View Slot

hilitedData

Clipboard Data Frame

aClipboardDataFrame := {
label : string, //string displayed by clipboard
types : array, //array of types arrays
data : array, //array of data arrays
bounds : frame, //where data came from
...}

Built-In Applications

Extras Drawer Folder Symbols

nil
'_extensions
'_help
'_setup
'_soups
 '_ButtonBar

Names Worksite Soup Entry

cityAlias

Newton Works Word Processor Soup Format

aWorksWordProcessorSoupEntry :=
{
class: 'paper, 
version: integer, 
title: string , 
timeStamp: integer,
realModTime: integer,
saveData: frame,
hiliteRange: frame,
margins: frame,

...}

User Configuration Variables

LCDContrast
alarmVolumeDb
soundVolumeDb
buttonBarPositions
buttonBarControlsPositions
bellyButtonPositions
buttonBarIconSpacingH
buttonBarIconSpacingV
extrasIconSpacingH
extrasIconSpacingV
extraFont

Protos

protoPasswordSlip

aPassWordSlip := {
_proto : protoPasswordSlip,
CurrentPassword : func() ..., //gets curr password
SetPassword : func(newPassword), //sets curr password
MatchPassword: func(newPassword, currentPassword)..., //do these match
MatchedPassword: func() ... , //called if there was a match
verifyPassword: symbolORtrueORnil, //should password be verified
 ...}

protoBlindEntryLine

aBlindEntryLine := {
_proto: protoBlindEntryLine,
dummyChar : character, //char to echo
UpdateText : func (newText), //updates text
realText : string, //the real text
label : string, //entry line label
 ...}

Constants

Views

Screen Orientation Constants

kPortrait

0

kLandscape

1

kPortraitFlip

2

kLandscapeFlip

3

Built-In Communcations Tools

Serial Communication Tool Sound Option

*kCMOPCMCIAModemSound "msnd"

Functions and Methods

Views

view:DragAndDrop(unit, bounds, limitBounds, copy, dragInfo)
//starts the drag and drop process (2.0 also)
view:DragAndDropLtd(unit, dragBounds, limitBounds, copy, dragInfo)
//starts the drag and drop process in limited area(platform file)
view:ViewAddDragInfoScript(dragInfo) //called if hilitedData is true
GetClipboard() //returns the contents of the clipboard
SetClipboard(clipboardData) //sets the contents of the clipboard

Stationery

RegStationeryChange(regSymbol, functionBody) 
//regs callback for stationey change
UnRegStationeryChange(regSymbol) //unregs a stationery change callback

Text Input and Display

GetAllFonts() // returns the installed user fonts
MakeFontMenu(font, families, sizes, styles) //makes a font menu

Recognition

RecognizeTextInStyles(textFrame, defaultFontSpec) 
//recognizes ink in a frame
RecognizeInkWord(inkWord) //recognizes an ink word

System Services

BatteryStatus(which) //returns info about a battery (2.0 also)

Built-In Applications

extrasDrawer:GetPartEntryData(entry) 
// gets info about an part entry (platform file - 2.0 also)
calendar:SetEntryAlarm(mtgText,mtgStartDate,minutesOrDaysBefore)
// sets an alarm for a meeting or event (2.0 also)
SetUserConfigEnMasse(changeSym, changeFrame)
// sets multiple user configuaration variables
RegUserConfigChange(callBackID, callBackFn)
//registers a callback for changes in a user configuration vars.
KillStdButtonBar(buttonBarParams)
// closes (or restores) the button bar
buttonBar:GetPartEntries() //returns part entries for parts in b. bar
buttonBar:ReConfigure(newSetup) //reconfigure the button bar
buttonBar:IconCapacity() // gets number of icons that fit in bb

Transports

transport:DeleteItem(item) //deletes item from In/Out box
transport:DeleteRemoteItems() //deletes remote items
transport:RefreshOwner() //refreshes the transport owner

Utility Functions

ROM_GetSerialNumber() //gets a units unique serial number
partFrame:ImportDisabled(unitName, majorVersion, minorVersion)
   //called to clean up when unit is disabled (2.0 also)
LegalOrientations() //gts legal values for sceen orientation (2.0 also)
GetOrientation() //gets current sceen orientation (2.0 also)
SetScreenOrientation(orientation) //sets sceen orientation 
GetAppParams() //gets system configuration (2.0 also)
Gestalt(selector) //gets info about the system (2.0 also)
TimeFrameStr(timeFrame, timeStrSpec) //returns string with time
LocalTime(time, where) //gets local time in a distant city (2.0 also)
DSTOffset(time, where) //gets DST component of a city's time(2.0 also)
SymbolName(symbol) //returns a string version of a symbol (2.0 also)

---

Subtopics

Data Structures

Views

View Slot

Clipboard Data Frame

Built-In Applications

Extras Drawer Folder Symbols

Names Worksite Soup Entry

Newton Works Word Processor Soup Format

User Configuration Variables

Protos

protoPasswordSlip

protoBlindEntryLine

Constants

Views

Screen Orientation Constants

Built-In Communcations Tools

Serial Communication Tool Sound Option

Functions and Methods

Views

Stationery

Text Input and Display

Recognition

System Services

Built-In Applications

Transports

Utility Functions