Index

A

Activate()

LPane 139

LWindow 352

UDesktop 357

UDesktop in dialogs 391

ActivateSelf()

LPane 136, 139

LWindow 352

active state 124

AddAttachment()

LAttachable 491

AddListener()

LBroadcaster 215, 217, 219

AddMenu()

LMenuBar 314

AddSubCommander()

LCommander 293

AdjustCursorSelf()

LPane 140

AdjustScrollBars()

LView 178, 180

adorner as MacApp class 490

aedt resource in PowerPlant 277

alignment in placeholder 454

AllowSubRemoval()

LCommander 293

LDialogBox 387

LSingleDoc 421

LWindow 355

AllowTargetSwitch()

LCommander 294, 295

Apple events

in LDocApplication 416

in PowerPlant 276, 277

application

and main() function 260

as commander 258

as design pattern 75

as event dispatcher 258

as scriptable object 258

as top commander 276, 293

checking environment 272

class hierarchy 97, 258

deriving 260

event handling 275

functions 259

implementing 427

initalize heap 268

initialize toolbox 268

initializing 260-275

memory management 269-272

overriding functions 260

quitting 260

registering classes 273

running 275

state 259

application framework

advantages 73

and interface 72

defined 72

design patterns in 74-83

flow of control in 73

utilities in 83

arrays 522-533

iterating 528

multiple iterators 530

AskForOneNumber()

UModalDialogs 389

AskForOneString()

UModalDialogs 390

AskPageSetup() 469

AskPrintJob() 469

AskSaveAs()

LDocument 419, 430

Assert_ macro 265

and side effects 265

AssignItemsAt()

LArray 525, 526

LVariableArray 526, 527

attachment 487-499

creating 495

defined 487

messages and data 494

strategy 490

uses for 496

when PowerPlant calls 493

when to use 495

AttemptClose()

LDialogBox 388

LDocument 419

LWindow 354, 355

AttemptQuit()

LCommander 293

AttemptQuitSelf()

LCommander 293, 294

LDocument 418

B

BeginDrawing()

LGWorld 351

BeginMarch()

UMarchingAnts 539

BeginSession() 469

behavior as MacApp class 490

BeTarget()

LCommander 295, 298

binding in a frame 138

BlockCompare() 271

used in LComparator 532

BlocksAreEqual() 271

broadcaster

defined 81

in design pattern 81

linking to listener 216, 219

broadcasting a message 217

BroadcastMessage()

LBroadcaster 216, 217, 218

LControl 218

listen in dialogs 385

BroadcastValueMessage()

LControl 218

listen in dialogs 385

button See control

buttons in PowerPlant 204

C

CalcLocalFrameRect()

LPane 138, 181

CalcPortFrameRect()

LPane 138, 181

CalcRevealedRect()

LView 178

calling Toolbox routines 67

cancel button in dialog 380, 382

caption See LCaption

Carbon

printing under 456

UCarbonPrinting.cp 456

Catch_ macro 267

chain of command 293

functions 293

maintaining 293

checking environment 272

ChooseDocument()

example 428

LDocApplication 416

class

interdependence in PowerPlant 90

name conventions 63

registering 273

class ID

reserved 130

when registering class 274

class library 71

ClearAttribute()

LWindow 339

click in a window 352

Click()

LPane 140

LWindow 353

ClickCell()

LTable 186

ClickInContent()

LWindow 353

ClickInDrag()

LWindow 353

ClickInGoAway

LWindow 353

ClickInGrow()

LWindow 349, 353

ClickInZoom()

LWindow 353

ClickMenuBar()

LEventDispatcher 306

ClickSelf()

LControl 213, 215

LListBox 146

LPane 134, 140

LWindow 349, 354

overriding 141

clipboard 519

clipping region 536

close

dialog 387

document 418, 421

window 354

CloseBox window attribute 337

CloseDataFork()

LFile 422

CloseResourceFork()

LFile 422

code library 70

coding conventions 63-68

command 291-299

calling inherited commander 307

chain of 293

class hierarchy 292

duty handling 295

handling 298

handling target 294

identifying synthetic 306

latency 296

maintaining chain of command 293

passing to supercommander 307

responding to 306

responding to quit as example 307

command hierarchy

as design pattern 76

command number 302

and menu item 108

explained 300

in Mcmd resource 302

negative 302

reserved numbers 302

synthetic 303

using synthetic 304

commander

default 294

defined 76

Compare()

LComparator 532

CompareToKey()

LComparator 532

constants name conventions 66

Constructor

described 59

to build controls 209

to build dialogs 382

to build panes 128

to build printout 459

to build views 169

to build windows 343

constructor, stream 132

Contains()

LPane 140

control 203-220

as pane 205, 210

broadcasting 218

characteristics listed 205

class hierarchy 203

constructors 211

creating 209-211

creating on the fly 211

defined 203

deriving 212

descriptor 207

drawing 213

hot spot in control 207

installing in a view 211

likely function overrides 212

linking to listener 216, 219

listening to other controls 212

managing descriptor 214

managing hot spot 214

managing values 214

message 206

message components 208

scroll bar 205

setting port for 211

standard Mac OS 204

title 207

using Constructor 209

value 206

coordinate conversion 181

and image size 181

coordinate systems 164-168

global 165

image 168

listed 164

local 167

port 166

window 166

CopyBits() (Mac OS)

and printing 467

CountPanels()

LPane 457

LPlaceHolder 455

LPrintout 453

LView 457

CreateNewDataFile()

LFile 422

CreateNewFile()

LFile 422

CreatePrintout()

LPrintout 459

CreateWindow()

LWindow 347

LWindow for dialogs 382

creator function 132, 273

and default commander 294

Current()

and variable length data 529

LArrayIterator 529

cursor, managing in a pane 140

D

Deactivate()

LPane 139

LWindow 352

UDesktop 357

UDesktop in dialogs 390

DeactivateSelf()

LPane 136, 139

LWindow 352

Debug_Signal 263

Debug_Throw 263

debugging 262-267

actions 263

Catch_ macro 267

errors and signals 262

macros listed 265, 266

options 263

signal side effects 265

strategy in PowerPlant 262

turning off 266

default button in dialog 380, 382

default commander 294

DelaySelect window attribute 339

DeleteAllSubPanes()

LView 177

deriving

application 260

controls 212

dialog 384

panes 132

printout 463

views 175

window 348

descriptor

in control 207

in document 420

in LSingleDoc 421

in pane 125, 138

design pattern defined 74

development process in PowerPlant 111

DevoteTimeToIdlers()

LPeriodical 484, 485

DevoteTimeToRepeaters()

LPeriodical 484

dialog 377-391

as listener 380

button tracking 380

characteristics 380

class hierarchy 379

closing 387

creating 381-385

creating on the fly 384

deriving 384

message handling 386, 387

mixing positive and negative messages 387

negative messages 386

overriding functions 384

pure modal in PowerPlant 379, 383

setting buttons 382

traditional 378

using Constructor 382

using Mac OS Dialog Manager 390

window kind 383

Dialog Manager (Mac OS) in PowerPlant 390

DialogSelect() (Mac OS) 378, 379

Disable()

LPane 139

disabled state 124

DisableSelf()

LPane 136, 139

DispatchEvent()

LApplication 275

DoAEClose()

LDocument 419

DoAEOpenOrPrintDoc()

LDocApplication 416, 464

DoAESave()

LDocument 419

tasks to implement 430

DoClose()

LDialogBox 387

LWindow 354, 355

document 412-421

and applications in design 413

closing 418, 421

constructor tasks 428

defined 412

design in PowerPlant 412

design responsibilities 413

implementing 428-431

in design pattern 82

list in application 417

opening 428

printing 465

resources in 431

reverting 431

saving 429

documentation for PowerPlant 57

DoDialog()

StDialogHandler 388

DontBeTarget()

LCommander 295, 298

DontRefresh()

LPane 136

DoPrint()

example 465

LDocument 419

tasks to implement 465

DoPrintJob()

LPrintout 452

DoQuit()

LApplication 259

DoRevert()

LDocument 419

DoSave()

LDocument 419

tasks to implement 430

DoSetBounds()

LWindow 349

DoSetZoom()

LWindow 349

drag and drop support 339

DragDeskWindow()

UDesktop 357

Draw()

LControl 213

LPane 134

LView 176

LWindow 134, 349

DrawCell()

LTable 186

drawing

and focus 176

control 213

on multiple monitors 537

pane 134

view 176

DrawSelf()

and printing 467

LControl 213

LPane 127, 134, 135

LPicture 187

LStdControl 135

LView 176

LWindow 134, 350

overriding 135

with multiple monitors 537

DrawWithJustification()

UTextDrawing 539

duty

and target 296

functions 297

handling 295

latency 296

dynamic menus 314

E

Enable()

LPane 139

enabled state 124

Enabled window attribute 338

EnableSelf()

LPane 136, 139

EndDrawing()

LGWorld 351

EndMarch()

UMarchingAnts 539

EndSession() 469

enumerated types name conventions 66

environment checking 272

EraseOnUpdate window attribute 338, 350

error See debugging

event dispatch

as design pattern 76

bottom-up 77

top-down 76

event handling in application 275

example code on CD 58

Execute()

LAttachment 493

ExecuteAttachments()

LAttachable 492

parameters 494

ExecuteSelf() 519

LAttachment 493

ExpandSubPane()

LView 177

ExportSelf() 519

LClipboard 520

F

factored behavior in PowerPlant 94

factored classes in PowerPlant 92

factored design in PowerPlant 90

FailNIL_ macro 266

FailOSErr_ macro 266

FetchBottomFloater()

UDesktop 357

FetchBottomModal()

UDesktop 358

FetchIndexOf()

LArray 525

FetchItemAt()

LArray 525, 526

LVariableArray 527

FetchMenu()

LMenuBar 315

FetchTopFloater()

UDesktop 357

FetchTopModal()

UDesktop 357

FetchTopRegular()

UDesktop 357

FetchWindowObject()

LWindow 358

file

in design pattern 82

name conventions 63

replacing existing 430

file I/O 412-431

FindCommandStatus()

and non-synthetic commands 311

and synthetic commands 313

in supercommander 312

LApplication 260

LCommander 298, 310

LDialogBox 385

LDocApplication 415

LDocument 418

LWindow 349

parameters 311

updates menu items 299

FindDeepSubPaneContaining()

LPane 141

LView 177

FindDominant Device()

UWindows 356

FindHotSpot()

LControl 215

FindNamedDocument()

LDocument 420

FindNamedWindow()

UWindows 356

FindNthWindow()

UWindows 356

FindPaneByID() 121, 131, 137, 162

LView 177

FindShallowSubPaneContaining()

LPane 141

LView 177

FindSubPaneHitBy()

LPane 141

LView 137, 177

FindWindowIndex()

UWindows 356

FinishCreate()

LControl 211

LPane 131

LView 174

FinishCreateSelf()

LControl 211

LDialogBox 380

LPane 131

LWindow 349

floating window 346

closing 355

focus 176

in application framework 80

setting 134

FocusDraw()

LView 134, 176

frame

binding 138

contents 127

for pane 121

LPrintout 450

framework

See also application framework

defined 71

difficulties using 72

from_End, iterating 529

from_Start, iterating 529

FrontWindowIsModal()

UDesktop 358

FSpExchangeFiles() (Mac OS) 431

FSRead() (Mac OS) 426

FSWrite() (Mac OS) 426

G

GetBytes()

LFileStream 426

GetClipboard() 519

LClipboard 519

GetCount()

LArray 525

GetCurrentMenuBar()

LMenuBar 314

GetCurrentPort()

UQDGlobals 358, 535

GetData()

LClipboard 519, 522

GetDataForkRefNum()

LFile 422

GetDataSelf() 519

LClipboard 520, 522

GetDefaultCommander()

LCommander 293

GetDescriptor()

LControl 214

LDocument 420

LPane 134, 138

LSingleDoc 421

LWindow 341

GetDescriptorForPaneID()

LView 178

GetDocumentList()

LDocument 420

GetEOF() (Mac OS) 426

GetFPos() (Mac OS) 426

GetFrameBinding()

LPane 138

GetFrameLocation()

LPane 138

GetFrameSize()

LPane 138

GetImageLocation()

LView 178

GetImageSize()

LView 178

GetItemSize()

LArray 525

GetLastPaneClicked()

LPane 140

GetLatentSub()

LCommander 297

GetLength()

LStream 424

GetMacListH()

LListBox 145

GetMacMenuH()

LMenu 315

GetMacPort()

for windowKind 342

LPane 358

LWindow 358

GetMarker()

LStream 424

GetMaxValue()

LControl 214

GetMenuID()

LMenu 315

GetMinMaxSize()

LWindow 340

GetMinValue()

LControl 214

GetPaneID()

LPane 137

GetPrintError() 469

GetPrintJobSpecs()

LPrintout 452

GetQDGlobals()

UQDGlobals 535

GetResourceForkRefNum()

LFile 422

GetRevealedRect()

LView 178

GetScrollPosition()

LView 179

GetScrollUnit()

LView 179

GetSelectClick window attribute 338

GetSpecifier()

LFile 422

GetStandardSize()

LWindow 341

GetState()

LApplication 259

GetSubPanes()

LView 177

GetSuperView()

LPane 137

GetTarget()

LCommander 294

GetTopCommander()

LCommander 293

GetUserCon()

LPane 139

GetValue()

LControl 214

LPane 134, 138

GetValueForPaneID()

LView 177

GetValueMessage()

LControl 214

GetWindowContent Rect()

UWindows 356

GetWindowStructure Rect()

UWindows 356

global coordinates 165

GlobalToPort Point()

LView 181

GrowZone() (Mac OS) 269

H

HandleAppleEvent()

LDocApplication 416

HandleClick()

LWindow 353

HandleCreateElementEvent()

LDocApplication 416

HandleKeyPress()

LCommander 298

LDialogBox 380

responds to keystroke 299

HasAttribute()

LPrintout 452

LWindow 339

HasFeature()

UEnvironment 273

hidden state 124

Hide()

LPane 139

LWindow 352

HideDeskWindow()

UDesktop 357

HideOnSuspend window attribute 338

HideSelf()

LWindow 352

hit testing in panes 140

HorizSBarAction()

LView 181

HorizScroll()

LView 180

host an attachment 487

hot spot 207

HotSpotAction()

LControl 213, 215

HotSpotResult()

LControl 213, 215

LStdCheckBox 227

I

idler periodical 483

image

as view characteristic 162

compared to frame 162

coordinates 168

managing in a view 178

size 181

ImagePointIsInFrame

LView 181

ImageRectIntersectsFrame()

LView 181

ImageToLocal Point()

LView 181

ImportSelf() 519

LClipboard 520, 521

inactive state 124

IncrementValue()

LControl 214

initialize

heap 268

QuickTime 269

Toolbox 268

Initialize()

LApplication 259, 260, 275

LApplication and menu creation 306

UQuickTime 269

InitializeHeap() 268

InitializeToolbox()

UQDGlobals 535

InsertCommand()

LMenu 315

InsertItemsAt()

LArray 525, 526

LVariableArray 526, 527

Installing Resource Templates

Rez 552

InstallOccupant()

LPlaceHolder 455

integer types 65

InvalPortRect()

LPane 136

InvalPortRgn()

LPane 136

IsActive()

LPane 139

IsActiveScreenDevice()

UDrawingUtils 537

IsBroadcasting()

LBroadcaster 216, 217

IsColorGrafPort()

UDrawingUtils 537

IsDialogEvent() (Mac OS) 378, 379

IsEnabled()

LPane 139

IsEqualTo()

LComparator 532

IsEqualToKey()

LComparator 532

IsHitBy()

LPane 140

IsListening()

LListener 219

IsOnDuty()

LCommander 297

IsSyntheticCommand()

LCommander 304, 307

IsTarget()

LCommander 295

IsVisible()

LPane 139

ItemIsEnabled()

LMenu 315

iterator

example 530

iterator, multiple 530

K

key filter 144, 539

keystroke handling 298

L

LActiveScroller 163

LAddColumn()

LListBox 145

LAddRow()

LListBox 145

LApplication 97

constructor 272

See also application

LArray 91, 524-526

LArrayIterator 91, 528

latent commander 296

latent subcommander 99

LAttachable 87

characteristics 491

class hierarchy 489

defined 488

functions 491

LAttachable See also attachment

LAttachment 519

class hierarchy 489

data members 492

defined 489

deriving 495

functions 493

See also attachment

layers for windows 336

LBeepAttachment 497

LBorderAttachment 498

LBroadcaster 86, 91, 103

and LControl 204

defined 208

described 215

LButton described 221

LCaption

described 142

descriptor in 125

erasing text

LCicnButton

described 222

LCLipboard 519-522

LClipboard

GetData() 519

SetData() 519

LCommandEnablerAttachment 498

LCommander 86, 98

chain of command functions 293

class hierarchy 100, 292

command handling functions 298

duty handling functions 297

features 292

See also command

target functions 294

LComparator 532

LControl 87, 203

and LBroadcaster 204

class hierarchy 203

See also control

LDataStream 426

LDefaultOutline described 142

LDialogBox

class hierarchy 379

LDocApplication 97, 258

class hierarchy 415

command handling 415

function interface 416

See also application

LDocument

class hierarchy 417

command handling 418

data members 417

described 417

functions 419

LEditField 87

as periodical 486

described 143

descriptor in 125

LEraseAttachment 498

LEventDispatcher 98

LFile 104

and data fork 423

and resource fork 423

as file systems 414

class hierarchy 424

data members 421

described 421

functions 422

LFileStream 104

described 426

functions 426

LFocusBox described 143

LGrafPortView described 183

LGroupBox described 142

LGrowZone

as broadcaster 269

as periodical 270, 486

class hierarchy 269

described 269

using in non-PowerPlant projects 269

LGWorld 350

drawing in 351

LHandleStream 426

LIconPane described 143

LinkListenerToControls() 216, 217, 219

for dialogs 384

listen to message 220

listener

defined 81

in design pattern 81

linking to broadcaster 216, 219

ListenToMessage()

in memory management 270

LDialogBox 384, 385, 386, 387

LDialogBox sending commands 386

LListener 217, 219, 220

LRadioGroup 220

lists

iterating 528

LKeyScrollAttachment 499

LListBox

compared to LTable 145

described 145

descriptor in 125

LListener 86, 91, 103

described 219

dialog as 380

LLockedArrayIterator 531

LLongComparator 532

LMenu 90

described 315

functions 315

using in non-PowerPlant code 315

LMenuBar 90

described 314

using in non-PowerPlant code 315

LModelObject 87

LMovieController

as periodical 486

described 143

LoadSystemTraits()

UTextTraits 544

LoadTextTraits()

UTextTraits 544

local coordinates 167

LocalToImage Point()

LView 181

LocalToPort Point()

LView 181

location, pane characteristic 121

LOffscreenView 350

described 184

LPaintAttachment 498

LPane 86, 102, 117

class hierarchy 118

descriptor in 126

printing functions 457

See also pane

value in 126

LPeriodical 87

class hierarchy 482

destructor 484

See also periodical

LPicture described 187

LPlaceHolder

characteristics 453

described 453

frame 458

functions 455

See also placeholder

LPreferencesFile 431

LPrintout

data members 451

frame 450, 458

See also printout

LPrintSpec 468

LRadioGroup 205

creating 231

LRunArray 527

LScroller 163

and controls 205

LSharable 534

LSingleDoc

data members 420

described 420

descriptor in 126

LStdButton described 226

LStdCheckBox described 227

LStdControl

described 225

descriptor in 125, 207

installing in a view 211

scroll bar 205

LStdPopupMenu

described 227

LStdRadioButton described 229

LStr255 533

LStream 104

class hierarchy 424

data members 424

described 424

functions 425

in document design 414

in stream constructor 132

overloaded operators 426

LString 91, 105, 533

LTabGroup described 144

LTable

compared to LListBox 145

described 185

LTextButton

described 223

descriptor in 207

erasing text

LTextEditView

as periodical 486

described 184

LToggleButton described 222

LVariableArray 526

LView 102

class hierarchy 159

described 161

printing functions 457

See also view

LWindow 93

class hierarchy 334

described 333

descriptor in 125

See also window

M

MakeAlias()

LFile 422

MakeNewDocument()

example 427

LDocApplication 416

MakeScrollBars()

LScroller 205, 211

maximum size, window 340

MBAR resource 301

Mcmd resource 108, 300, 301

and command number 302

type 58

member access in PowerPlant 93

memory classes 270, 271

memory management 269-272

allocating and deallocating 270

other strategies 272

reserve strategy 269

menu 299-315

adding dynamically 314

adding to application 305

clear a mark 311

command number See command number

default dispatch chain 306

effect of reorganizing 300

enable item 311

forcing update 310

mark an item 311

modify item text 312

modifying items 311

passing update to supercommander 312

real-time updating 309

removing dynamically 314

resources in PowerPlant 301

responding to choice 306

updating 308-314

updating in PowerPlant 309

updating negative items 312

updating non-synthetic items 311

updating synthetic items 313

when PowerPlant updates 310

when to update 308

working with Mac OS Menu Manager 315

MENU resource 301

MenuSelect() (Mac OS) 300, 304

message

broadcasting 217

components 208, 217

in control 206

in dialog 386

listening to 220

sending command as 208

messaging system design pattern 81

minimum size, window 340

mix-in class 86, 88

ModalDialog() (Mac OS) 378, 379, 388, 390

modeless dialog

window kind 383

mouse information in a pane 126

MouseEnter()

LPane 140

MouseLeave()

LPane 140

MouseWithin()

LPane 140

MoveBy()

LPane 138

MoveItem()

LArray 525

msg_AdjustCursor 140

msg_ControlClicked 217, 218

multiple inheritance

compared to single 88

in PowerPlant 86

mValue 208, 218

compared to mValueMessage 206

mValueMessage 206, 208, 218

compared to mValue 206

N

naming conventions 63-68

negative messages in dialogs 386

NewDeskWindow()

UDesktop 357

Next()

and variable length data 529

LArrayIterator 529

Normalize()

in drawing state classes 536

NormalizeWindowOrder()

UDesktop 358

O

ObeyCommand()

and command numbers 300, 306

and printing 465

and synthetic commands 304

calling inherited 307

LApplication 260, 307

LCommander 298

LDialogBox 384, 385, 387

LDocApplication 415

LDocument 418

LWindow 307, 349

responds to commands 299

typical functionality 306

occupant 454

installing in placeholder 455

removing from placeholder 455

offscreen drawing 350

OpenDataFork()

LFile 422

OpenDocument()

example 427

LDocApplication 416

opening a document 428

OpenOrCreateResourceFork()

LPreferencesFile 432

OpenResourceFork()

LFile 422

OrientSubPane()

LView 177

overloaded operators

defined 94

LStream 426

LString 534

overloading defined 94

overriding defined 94

P

page numbering 451

pane 117-141

adding to a view 176

characteristics 119-127

characteristics listed 120

characteristics of non-view 120

class hierarchy 118

class ID 130

constructors 131

contents 127

creating 128-131

creating on the fly 130

cursor management 140

defined 117

deriving 132

descriptor 125, 138

drawing 127, 134

frame 121

frame binding 138

hit testing 140

ID 121, 137

ID in Constructor 129

invalidating area 136

kinds of classes 102

likely function overrides 133

location 121

managing state 139

mouse information in 126

parts described 122

printing 467

removing from a view 176

size 121

state 123, 124

updating 136

using Constructor 128

value 125, 138

PaneIDT data type 121

panel

counting 457

in a pane 457

in printing 449

paper size 450, 458, 470

parameter name conventions 64

pattern See design pattern

PeekData()

LStream 425

periodical 482-487

defined 482

flexibility 487

idlers 485

limitations 487

queues 483

removing from queue 484

repeaters 484

spending time 485

persistence 412

placeholder

alignment 454

in printing strategy 448

installing occupant 455

margins when printing 462

occupant 454

removing occupant 455

setting default alignment 462

PlaceInSuperFrameAt()

LPane 131, 138

PlaceInSuperImageAt()

LPane 131, 138

PointInHotSpot()

LControl 215

PointIsInFrame()

LControl 213, 215

port coordinates 166

port, getting Mac OS GrafPort 359

PortToGlobal Point()

LView 181

PortToLocal Point()

LView 181

PowerPlant

calling Toolbox routines 67

coding conventions 63-68

defined 19

documentation 57

example code on CD 58

factored behavior 94

factored classes 92

factored design 90

installing 56

installing resource templates 58-60

integer data types 65

member access 93

multiple inheritance in 86

resources 105

runtime requirements 56

source code folders 57

PP_Window_Kind described 342

PPob resource 58, 106

preferences file 431

Previous()

and variable length data 529

LArrayIterator 529

PrintCopiesOfPages()

LPrintout 452

overriding 463

PrintDocument()

LDocApplication 416

overriding 464

tasks to implement 464

printing 447-469

areas 458

creating a hierarchy 459-463

document 463-466

from the Finder 464

margins 462

page numbering 451

panel 449

panes 467

paper size 450, 458, 470

view 467

window 465

printout

characteristics 461

creating on the fly 462

deriving 463

in printing strategy 448

overriding functions 463

using Constructor 459

PrintPanel()

LPane 457

LPrintout 453

LView 457

PrintPanelRange()

LPrintout 452

overriding 463

PrintPanelSelf()

LPane 457

LView 457

need to override 458

overriding 467

problem domain 71

ProcessCommand()

calling supercommander in dialog 386

in supercommander 307

LCommander 306

LDialogBox 385, 386

ProcessNextEvent()

LApplication 259, 275

profiling code 541

PutBytes()

LFileStream 426

PutChainOnDuty()

LCommander 297

PutInside()

LPane 131, 137

LView 176

PutOnDuty()

LCommander 297, 298

Q

QuickDraw space 165

QuickTime, initializing 269

R

ReadAll()

LStream 425

ReadCString()

LStream 425

ReadData()

LStream 425

ReadDataFork()

LFile 422

LFileStream 427

ReadHandle()

LStream 425

ReadPString()

LStream 425

ReadPtr()

LStream 425

reconcile overhang 171

refCon

in Constructor 347

in Mac OS 347

in WIND 348

Refresh()

LPane 136

RegisterClass()

URegistrar 274

RegisterClass_() 274

registering PowerPlant classes 273

Remove()

LArray 525

RemoveAllAttachments()

LAttachable 492

RemoveAttachment()

LAttachable 491

RemoveCommand()

LMenu 315

RemoveItem()

LMenu 315

RemoveItemsAt()

LArray 525, 526

RemoveListener()

LBroadcaster 215

RemoveMenu()

LMenuBar 314

RemoveOccupant()

LPlaceHolder 455

RemoveSubCommander()

LCommander 293

repeater periodical 483

replacing files 430

ResEdit, resource templates for 60

ResetTo()

LArrayIterator 529

Resizable window attribute 337

ResizeFrameBy()

LPane 138

ResizeFrameTo()

LPane 138

ResizeImageBy()

LView 178

ResizeImageTo()

LView 178

Resorcerer, resource templates for 59

resource ID name conventions 66

resources

in PowerPlant 105

installing templates 58-60

reading and writing 423

Resume()

LWindow 352

UDesktop 357

reverting a document 431

Rez, resource templates for 60

RidL resource 59, 109, 216

customizing 217

Run()

LApplication 259, 275

LApplication and menu creation 306

runtime requirements for PowerPlant apps 56

S

saving a document 429

SBooleanRect 123

scroll management 178

scrolling view ID 180

scrolling with an attachment 499

ScrollToPanel()

LPane 457

LPlaceHolder 455

LView 457

SDialogResponse structure 386

Select()

LWindow 352

SelectDeskWindow()

UDesktop 357

SendAECreateDocument()

LDocApplication 416

SendAEOpenDoc()

LDocApplication 416

SendAEQuit()

LApplication 259

SetAttribute()

LPrintout 452

LWindow 339

SetCancelButton()

LDialogBox 380

SetCommand()

LMenu 315

SetComparator()

LComparator 526

SetData()

LClipboard 519, 522

SetDataSelf() 519

LClipboard 520, 522

SetDefaultButton()

LDialogBox 380

SetDefaultCommander()

LCommander 293

SetDefaultView()

LView 175

SetDescriptor()

LControl 214

LPane 134, 138

LWindow 341

SetDescriptorForPaneID()

LView 178

SetEOF() (Mac OS) 426

SetFPos() (Mac OS) 426

SetFrameBinding()

LPane 138

SetHiliteModeOn()

UDrawingUtils 537

SetLatentSub()

LCommander 297, 298

SetLength()

LStream 424

SetMarker()

LStream 424

SetMaxValue()

LControl 214

SetMinMaxSize()

LWindow 340

SetMinValue()

LControl 214

SetPaneID()

LPane 137

SetPortTextTraits()

UTextTraits 544

SetQDGlobals()

UQDGlobals 535

SetScrollUnit()

LView 179

SetSleepTime()

LApplication 259

SetSpecifier()

LFile 422

SetStandardSize()

LWindow 341

SetSuperCommander()

LCommander 293

SetTETextTraits()

UTextTraits 544

SetUpdateCommandStatus()

LCommander 310

SetUserCon()

LPane 139

SetValue()

LControl 214

LPane 134, 138

LStdRadioButton 218

SetValueForPaneID()

LView 177

SetValueMessage()

LControl 214

Show()

LPane 139

LWindow 352

ShowAboutBox()

LApplication 259, 260

ShowDeskWindow()

UDesktop 357

ShowNew window attribute 338

ShowSelf()

LWindow 352

signal macro

and side effects 265

signal macros 265

signal See debugging

SimulateHotSpotClick()

LControl 215

single-inheritance compared to multiple 88

size

for pane 121

window 340

SizeBox window attribute 337

source code folders 57

SPaneInfo 130, 132, 174, 175

SpendTime()

in memory management 270

LPeriodical 484

overriding 486

stack-based classes 105

memory 270

standard controls 204

standard state for window 340

StartBroadcasting()

LBroadcaster 215, 217

StartIdling()

LPeriodical 484

StartListening()

LListener 219

StartRepeating()

LPeriodical 484

StartUp()

LApplication 259, 260, 276

state

in a pane 123

in application 259

in windows 352

stationery files in PowerPlant 261

StClipRgnState 536

StColorPenState 536

StColorPortState 536

StColorState 536

StDeviceLoop 537

StDialogHandler 388

and periodicals 487

StEmptyVisRgn 536

StHidePen 536

StOffscreenGWorld 184

StopBroadcasting()

LBroadcaster 215, 217

StopIdling()

LPeriodical 484

StopListening()

LListener 219

StopRepeating()

LPeriodical 484

StPortOriginState 536

StProfileSection 105, 541

stream

defined 423

in design pattern 82

stream constructor 132

strings in PowerPlant 533

structure name conventions 67

StTextState 536

subpane defined 161

SuperPrintPanel()

LPane 457

LView 457

superview defined 120

Suspend()

LWindow 352

UDesktop 357

SViewInfo 174, 175

SwapItems()

LArray 525

SWindowInfo 348

for dialogs 384

SwitchTarget()

LCommander 294

T

TakeChainOffDuty()

LCommander 297

TakeOffDuty()

LCommander 297, 298

target

and duty 296

becoming 295

defined 77

handling 294

switching 295

Targetable window attribute 338

TArray 528

TArrayIterator 531

text button See LTextButton

text traits 544

this->, use in PowerPlant 68

Throw_ macro 262, 263, 265

listed 266

TitleBar window attribute 337

TLockedArrayIterator 531

TrackHotSpot

LControl 213

TrackHotSpot()

LControl 215

TString 533

Txtr resource 59, 110, 544

U

UCarbonPrinting.cp 456

UClassicPrinting.cp 456

UDebugging 92, 105

UDesktop

described 356

different versions 357

functions 357

used by LWindow 352

UDrawingState 535

UDrawingUtils 105, 537

UEnvironment 105

UKeyFilters 91, 105, 144, 539

UMarchingAnts 538

UModalDialogs 105, 389

UpdatePort()

LWindow 134

UPrinting

AskPageSetup() 469

AskPrintJob() 469

BeginSession() 469

EndSession() 469

GetPrintError() 469

UPrinting.cp 456

UPrinting.h 456

UProfiler 541

UResourceManager 542

UScreenPort 535

user state for window 340

UTextDrawing 539

UTextTraits 544

utilities

for windows 355

in an application framework 83

memory 270

utility classes 104

UWindows 105

described 356

functions 356

V

ValidPortRect()

LPane 136

ValidPortRgn()

LPane 136

value

in a control 206

in a pane 125, 138

variable name conventions 64

VertSBarAction()

LView 181

VertScroll()

LView 180

view 159-183

add subpanes 176

as commander 80

characteristics 161-168

characteristics listed 161

class hierarchy 159

classes 102

constructors 174

coordinate systems 164

creating 169-175

creating on the fly 174

defined 159

deriving 175

drawing 176

image 162

image management 178

in application framework 79

in superview 170

pane information in 170

printing 467

reconcile overhang 171

remove subpanes 176

scroll management 178

subpanes 161

using Constructor 169

visible state 124

visual hierarchy

and controls 211

as design pattern 79

defined 160

finding top container 176

in application framework 79

in PowerPlant 103

maintaining 175, 176

managing panes in 137

W

window 333-359

as commander 334

as LWindow and WindowRecord 334

as pane 334

as view 334

attributes 335-339

attributes listed 336

characteristics 335-342

class hierarchy 334

click attributes 338

click in content 353

click in peripheral control 353

closing 354

creating 343-349

creating on the fly 348

deriving 348

descriptor 341

drawing 349

drawing attributes 338

drawing offscreen 349

floating 337, 346, 355

handling click 352

hide 351

in document design 414

layers 336

maximum size 340

minimum size 340

modal 336

overriding functions 349

pane information in 345

peripheral controls 337

positioning 347

printing 465

refCon 347, 348

regular 337

select 351

setting attributes at runtime 339

setting attributes in Constructor 345

setting window kind in Constructor 347

setting window kind in WIND 348

show 351

size 340

standard state 340

state 352

title 341

type 346

user state 340

userCon 347

using Constructor 343

utilities 355

window kind 342

Window Manager (Mac OS) 358

zooming 340

window coordinates 166

window kind

getting in PowerPlant 342

setting in Constructor 347

setting in WIND 348

use in PowerPlant 342

Window Manager (Mac OS) 358

WindowIsSelected()

UDesktop 357

WriteCString()

LStream 425

WriteData()

LStream 425

WriteDataFork()

LFile 422

LFileStream 427

WriteHandle()

LStream 425

WritePString()

LStream 425

WritePtr()

LStream 425

Z

Zoomable window attribute 337

zooming a window 340