Index

A

accessor functions 18-19, 22

ACCESSOR_CALLS_ARE_FUNCTIONS preprocessor symbol 18, 19, 20

Add Files dialog box 13

Add Files command 13

AddEventTypesToHandler function 25

AddTypes function 25

Adopting the Carbon Printing Manager 27

AM Implementations folder 13

AppearanceLib 12

Apple Developer Connection (ADC) 10

Apple Developers' Web site 7, 10, 17, 27, 29

Apple events 21

application file name 11-12

application suspend event 21

arrow QuickDraw global variable 19

B

build target

adding CarbonLib to 12-13

application file name 11-12

for Carbon development 11

C

C/C++ Language settings panel 15

CallNextEventHandler function 22

Carbon application programming interface (API) 5

creating build target for 11

defined 5

development system, setting up 9-10

documentation 7

events 21-26

preparing for development 9-16

printing 26-28

projects, updating for 11-16

Scrap Manager 29

Carbon Event Manager 22

Carbon events 9, 10, 21-26

application suspend 21

event class 21

event handlers 21, 22-23

event reference 22

event target 21-22, 24

event type 21

event type specifier 24

key-down 21

mouse-down 21, 24

mouse-dragged 24

mouse-up 24

PowerPlant classes for 23-26

process-command 21

properties 21-22

window close 21

window update 21

_Carbon Events folder 23

Carbon Implementation Libraries folder 10

Carbon Porting Guide 7, 17, 18

Carbon Support folder 10

CarbonEvents.h file 21, 22, 24

Carbonizing code 17-30

CarbonLib 9-10

1.0.4 9-10

1.1 10

adding to build target 12-13

defined 9

Software Development Kit (SDK), installing 10

CarbonLib extension 10

CD-ROM, CodeWarrior 5

CFMSYSTEMCALLS preprocessor symbol 29

classes, PowerPlant

for Carbon events 23-26

LDocument 28

LEventHandler 24-25

LEventHandlerFunctor 25, 26

LPrintout 27

LPrintSpec 27-28

TEventHandler 25-26

UPrinting 27

UPrintingMgr 27

UQDGlobals 19

UTBAccessors 19, 20

Classic Mac OS 5, 9, 17, 27

Printing Manager 26, 27

Classic model (printing) 27

Clone existing target option 11

code, Carbonizing 17-30

CodeWarrior

build target for Carbon development 11

CD-ROM 5

documentation 6-7

folder 5, 10

Integrated Development Environment (IDE) 10, 13

License Agreement 6

package 5

Pro 6 installer 9, 10

Project Inspector 12-13

project window 11, 12

projects, updating for Carbon development 11-16

release notes 5

year 2000 (Y2K) compliance 6

commands

Add Files 13

Create New Target 11

Project Inspector 12

Target Settings 11

compilation options, setting 15-16

conditional compilation 18, 19, 20, 29

constants

kEventClassMouse 24

kEventRightMouseDown 24

kEventRightMouseDragged 24

kEventRightMouseUp 24

containment hierarchy 21

contrlOwner field (control record) 18

control record (Classic Mac OS) 18

contrlOwner field 18

ControlsLib 12

Create New Target command 11

creating a Carbon build target 11

CustomTextColorCDEF folder 13

CustomTextColorCDEF.cp file 13

CustomTextColorCDEF.rsrc file 14

D

data structures

control record (Classic Mac OS) 18

event record (Classic Mac OS) 22

opaque 17-19, 22, 26

page format record 26, 28

print record (Classic Mac OS) 26, 27, 28

print settings record 26, 28

printing context 26

printing port (Classic Mac OS) 26

transparent 17, 18

data types

EventHandlerCallRef 22

EventHandlerResult 22

EventHandlerUPP 24

EventRef 22

EventTargetRef 24

EventTypeSpec 24

HandlerFunc 26

development system, setting up for Carbon 9-10

dialog boxes

Add Files 13

New Target 11

documentation 6-7

Adopting the Carbon Printing Manager 27

Carbon 7

Carbon Porting Guide 7, 17, 18

CodeWarrior 6-7

Getting to Know the Carbon Scrap Manager 29

Mac OS X 7

PowerPlant Advanced Topics 7

PowerPlant Book, The 7

PowerPlant Reference 7

release notes, CodeWarrior 5

DoPrint function 28

E

event class 21

event handlers 21, 22-23

default 22

installing 24-25

pre- and postprocessing 22-23

prototype 22

event loop 21, 23

event record (Classic Mac OS) 22

event reference 22

event target 21-22, 24

containment hierarchy 21

event type 21

event type specifier 24

EventHandlerCallRef data type 22

EventHandlerResult data type 22

EventHandlerUPP data type 24

EventRef data type 22

events, Carbon 9, 10, 21-26

application suspend 21

event class 21

event handlers 21, 22-23

event reference 22

event target 21-22, 24

event type 21

event type specifier 24

key-down 21

mouse-down 21, 24

mouse-dragged 24

mouse-up 24

PowerPlant classes for 23-26

process-command 21

properties 21-22

window close 21

window update 21

EventTargetRef data type 24

EventTypeSpec data type 24

Extensions folder 10

F

files

CarbonEvents.h 21, 22, 24

CustomTextColorCDEF.cp 13

CustomTextColorCDEF.rsrc 14

LAMImageWellIMP.cp 13

LMacTCPInetMapper.cp 14

LMacTCPListenQueue.cp 14

LMacTCPSupport.cp 14

LMacTCPTCPEndpoint.cp 14

LMacTCPTCPSendQueue.cp 14

LMacTCPUDPEndpoint.cp 14

LMacTCPUDPSendQueue.cp 14

MercutioAPI.h 30

prefix 15-16, 18

UCarbonPrinting.cp 27

UClassicDialogs.cp 14, 28

UClassicPrinting.cp 27

UConditionalDialogs.cp 14, 28

UControlMgr.cp 13

UDesktop.cp 14

UFloatingDesktop.cp 14

UNavServicesDialogs.cp 28

UPrinting.cp 13, 27

UPrinting.h 27

UPrintingMgr.cp 14

UProcessMgr.cp 13

UScrap.cp 13, 29

UScrap.h 29

USessionPrinting.cp 27

UStandardDialogs.i 28

UStandardFile.cp 14

UWMgr20Desktop.cp 13

Files view (project window) 12

folders

AM Implementations 13

_Carbon Events 23

Carbon Implementation Libraries 10

Carbon Support 10

CodeWarrior 5, 10

CustomTextColorCDEF 13

Extensions 10

Release Notes 5

Standard Dialogs 28

StubLibraries 13

Support Classes 13

system 10

Universal 10

Utility Classes 13, 29

functions

accessor 18-19, 22

AddEventTypesToHandler 25

AddTypes 25

CallNextEventHandler 22

DoPrint 28

GetApplicationEventTarget 24

GetArrow 19, 20

GetCurrentPort 19

GetEventClass 22

GetEventKind 22

GetEventTime 22

GetRandomSeed 19

InitGraf 20

InitializeToolbox 20-21

Install 24-25, 25-26

PMBeginDocument 27

PMBeginPage 27

PMEndDocument 27

PMEndPage 27

PMSessionBeginDocument 27

PMSessionBeginPage 27

PMSessionEndDocument 27

PMSessionEndPage 27

PrCloseDoc 27

PrClosePage 27

PrOpenDoc 27

PrOpenPage 27

QuitApplicationEventLoop 21

Remove 25

RemoveEventHandler 25

RemoveEventTypesFromHandler 25

RemoveTypes 25

RunApplicationEventLoop 21

WaitNextEvent 21, 23

G

GENERATING68881 preprocessor symbol 29

GENERATING68K preprocessor symbol 29

GENERATINGCFM preprocessor symbol 29, 30

GENERATINGPOWERPC preprocessor symbol 29

GetApplicationEventTarget function 24

GetArrow function 19, 20

GetControlOwner accessor function 18

GetCurrentPort function 19

GetEventClass function 22

GetEventKind function 22

GetEventTime function 22

GetRandomSeed function 19

Getting to Know the Carbon Scrap Manager 29

globals, QuickDraw 19-21

arrow 19

initialization 20-21

randSeed 19

thePort 19

H

HandlerFunc data type 26

I

InitGraf function 20

InitializeToolbox function 20-21

Install function 24-25, 25-26

installer, CodeWarrior Pro 6 9, 10

installing

CarbonLib Software Development Kit (SDK) 10

event handlers 24-25

Integrated Development Environment (IDE), CodeWarrior 10, 13

InterfaceLib 12

K

kEventClassMouse constant 24

kEventRightMouseDown constant 24

kEventRightMouseDragged constant 24

kEventRightMouseUp constant 24

key-down event 21

L

LAMImageWellIMP.cp file 13

LDocument PowerPlant class 28

mPrintRecordH member variable 28

mPrintSpec member variable 28

LEventHandler PowerPlant class 24-25

LEventHandlerFunctor PowerPlant class 25, 26

libraries

AppearanceLib 12

CarbonLib 10, 12-13

Classic 12-13

ControlsLib 12

InterfaceLib 12

MathLib 12

Metrowerks Standard Libraries (MSL) 12

MrCExceptionsLib 10

ObjectSupportLib 12

stub 12

WindowsLib 12

License Agreement, CodeWarrior 6

LMacTCPInetMapper.cp file 14

LMacTCPListenQueue.cp file 14

LMacTCPSupport.cp file 14

LMacTCPTCPEndpoint.cp file 14

LMacTCPTCPSendQueue.cp file 14

LMacTCPUDPEndpoint.cp file 14

LMacTCPUDPSendQueue.cp file 14

LPrintout PowerPlant class 27

LPrintSpec PowerPlant class 27-28

M

Mac OS 8/9 5, 9

Mac OS X 5, 9, 17, 21, 26

documentation 7

Macintosh Operating System (Mac OS)

Classic 5, 9, 17, 27

documentation 7

OS 8/9 5, 9

OS X 5, 9, 17, 21, 26

system folder 10

Toolbox 17

year 2000 (Y2K) compliance 6

MacTCP 15, 29

MathLib 12

member variables

mPrintRecordH (LDocument) 28

mPrintSpec (LDocument) 28

menus

Project 11, 13

Window 12

Mercutio MDEF 30

MercutioAPI.h file 30

Metrowerks Standard Libraries (MSL) 12

models, printing 27

Carbon non-session 27

Carbon session 27

Classic 27

mouse-down event 21, 24

mouse-dragged event 24

mouse-up event 24

mPrintRecordH member variable (LDocument) 28

mPrintSpec member variable (LDocument) 28

MrCExceptionsLib 10

MSL. See Metrowerks Standard Libraries

N

namespaces, PowerPlant

UScrap 29

Navigation Services package 28

preprocessor symbols for 15

New Target dialog box 11

non-session model, Carbon printing 27

O

ObjectSupportLib 12

opaque data structures 17-19, 22, 26

Open Transport 29

preprocessor symbols for 15-16

OS 8/9, Mac 5, 9

OS X, Mac 5, 9, 17, 21, 26

documentation 7

OTCARBONAPPLICATION preprocessor symbol 16

P

page format record 26, 28

PMBeginDocument function 27

PMBeginPage function 27

PMEndDocument function 27

PMEndPage function 27

PMSessionBeginDocument function 27

PMSessionBeginPage function 27

PMSessionEndDocument function 27

PMSessionEndPage function 27

PM_USE_SESSION_APIS preprocessor symbol 27

Porting Guide, Carbon 7, 17, 18

PowerPlant Advanced Topics 7

PowerPlant Book, The 7

PowerPlant classes

for Carbon events 23-26

LDocument 28

LEventHandler 24-25

LEventHandlerFunctor 25, 26

LPrintout 27

LPrintSpec 27-28

TEventHandler 25-26

UPrinting 27

UPrintingMgr 27

UQDGlobals 19

UTBAccessors 19, 20

PowerPlant files

adding new 14

CustomTextColorCDEF.cp 13

CustomTextColorCDEF.rsrc 14

LAMImageWellIMP.cp 13

LMacTCPInetMapper.cp 14

LMacTCPListenQueue.cp 14

LMacTCPSupport.cp 14

LMacTCPTCPEndpoint.cp 14

LMacTCPTCPSendQueue.cp 14

LMacTCPUDPEndpoint.cp 14

LMacTCPUDPSendQueue.cp 14

new (table) 13

obsolete (table) 14

removing obsolete 14

UClassicDialogs.cp 14

UConditionalDialogs.cp 14

UControlMgr.cp 13

UDesktop.cp 14

UFloatingDesktop.cp 14

UPrinting.cp 13

UPrintingMgr.cp 14

UProcessMgr.cp 13

UScrap.cp 13

UStandardFile.cp 14

UWMgr20Desktop.cp 13

PowerPlant namespaces

UScrap 29

PowerPlant Reference 7

PPC Target settings panel 12

PP_StdDialogs_ClassicOnly preprocessor symbol 28

PP_StdDialogs_Conditional preprocessor symbol 28

PP_StdDialogs_NavServicesOnly preprocessor symbol 15, 28

PP_StdDialogs_Option preprocessor symbol 15, 28

PP_Target_Carbon preprocessor symbol 15, 20, 27

PP_Target_Classic preprocessor symbol 15

PRAGMA_ALIGN_SUPPORTED preprocessor symbol 29, 30

PRAGMA_STRUCT_ALIGN preprocessor symbol 29

PrCloseDoc function 27

PrClosePage function 27

Prefix File option 15

prefix files 15-16, 18

preparing for Carbon development 9-16

preprocessor symbols

ACCESSOR_CALLS_ARE_FUNCTIONS 18, 19, 20

CFMSYSTEMCALLS 29

GENERATING68881 29

GENERATING68K 29

GENERATINGCFM 29, 30

GENERATINGPOWERPC 29

obsolete 29-30

OTCARBONAPPLICATION 16

PM_USE_SESSION_APIS 27

PP_StdDialogs_ClassicOnly 28

PP_StdDialogs_Conditional 28

PP_StdDialogs_NavServicesOnly 15, 28

PP_StdDialogs_Option 15, 28

PP_Target_Carbon 15, 20, 27

PP_Target_Classic 15

PRAGMA_ALIGN_SUPPORTED 29, 30

PRAGMA_STRUCT_ALIGN 29

TARGET_API_MAC_CARBON 15

TARGET_API_MAC_OS8 15

TARGET_CPU_68K 29

TARGET_CPU_PPC 29

TARGET_RT_MAC_68881 29

TARGET_RT_MAC_CFM 29

USE_MACTCP 16

print record (Classic Mac OS) 26, 27, 28

print settings record 26, 28

printing 26-28

Carbon non-session model 27

Carbon session model 27

Classic model 27

models 27

sessions 27

printing context 26

Printing Manager, Classic 26, 27

printing models 27

Carbon non-session 27

Carbon session 27

Classic 27

printing port (Classic Mac OS) 26

process-command event 21

Project Inspector 12-13

Targets view 12

Project Inspector command 12

Project menu 11, 13

project window 11, 12

Files view 12

Targets view 11

projects, CodeWarrior

updating for Carbon development 11-16

PrOpenDoc function 27

PrOpenPage function 27

Q

QuickDraw globals 19-21

arrow 19

initialization 20-21

randSeed 19

thePort 19

QuitApplicationEventLoop function 21

R

randSeed QuickDraw global variable 19

Release Notes folder 5

release notes, CodeWarrior 5

Remove function 25

RemoveEventHandler function 25

RemoveEventTypesFromHandler function 25

RemoveTypes function 25

RunApplicationEventLoop function 21

S

Scrap Manager, Carbon 29

session model, Carbon printing 27

sessions, printing 27

setting up a Carbon development system 9-10

settings panels

C/C++ Language 15

PPC Target 12

Standard Dialogs folder 28

Standard File Package 15, 28

stub libraries 12

StubLibraries folder 13

Support Classes folder 13

symbols, preprocessor

ACCESSOR_CALLS_ARE_FUNCTIONS 18, 19, 20

CFMSYSTEMCALLS 29

GENERATING68881 29

GENERATING68K 29

GENERATINGCFM 29, 30

GENERATINGPOWERPC 29

obsolete 29-30

OTCARBONAPPLICATION 16

PM_USE_SESSION_APIS 27

PP_StdDialogs_ClassicOnly 28

PP_StdDialogs_Conditional 28

PP_StdDialogs_NavServicesOnly 15, 28

PP_StdDialogs_Option 15, 28

PP_Target_Carbon 15, 20, 27

PP_Target_Classic 15

PRAGMA_ALIGN_SUPPORTED 29, 30

PRAGMA_STRUCT_ALIGN 29

TARGET_API_MAC_CARBON 15

TARGET_API_MAC_OS8 15

TARGET_CPU_68K 29

TARGET_CPU_PPC 29

TARGET_RT_MAC_68881 29

TARGET_RT_MAC_CFM 29

USE_MACTCP 16

system folder 10

T

Target Settings window 11, 12

Target Settings command 11

target, build

adding CarbonLib to 12-13

application file name 11-12

for Carbon development 11

TARGET_API_MAC_CARBON preprocessor symbol 15

TARGET_API_MAC_OS8 preprocessor symbol 15

TARGET_CPU_68K preprocessor symbol 29

TARGET_CPU_PPC preprocessor symbol 29

TARGET_RT_MAC_68881 preprocessor symbol 29

TARGET_RT_MAC_CFM preprocessor symbol 29

Targets view

Project Inspector window 12

project window 11

Targets view (project window) 11

TEventHandler PowerPlant class 25-26

thePort QuickDraw global variable 19

Toolbox, Mac OS 17

transparent data structures 17, 18

U

UCarbonPrinting.cp file 27

UClassicDialogs.cp file 14, 28

UClassicPrinting.cp file 27

UConditionalDialogs.cp file 14, 28

UControlMgr.cp file 13

UDesktop.cp file 14

UFloatingDesktop.cp file 14

UNavServicesDialogs.cp file 28

Universal folder 10

Universal Interfaces 10, 19, 20, 21, 22, 24

3.3.1 10

3.4 10

Universal Interfaces 3.3.1 29

Universal Interfaces 3.4 29

universal procedure pointer (UPP) 24

updating projects for Carbon development 11-16

UPP. See universal procedure pointer

UPrinting PowerPlant class 27

UPrinting.cp file 13, 27

UPrinting.h file 27

UPrintingMgr PowerPlant class 27

UPrintingMgr.cp file 14

UProcessMgr.cp file 13

UQDGlobals PowerPlant class 19

UScrap PowerPlant namespace 29

UScrap.cp file 13, 29

UScrap.h file 29

USE_MACTCP preprocessor symbol 16

USessionPrinting.cp file 27

UStandardDialogs.i file 28

UStandardFile.cp file 14

UTBAccessors PowerPlant class 19, 20

Utility Classes folder 13, 29

UWMgr20Desktop.cp file 13

V

variables, member

mPrintRecordH (LDocument) 28

mPrintSpec (LDocument) 28

W

WaitNextEvent function 21, 23

window close event 21

Window menu 12

window update event 21

windows

Target Settings 11, 12

WindowsLib 12

World Wide Web

Apple Developers' site 7, 10, 17, 27, 29

Y

year 2000 (Y2K) compliance

CodeWarrior 6

Mac OS 6