book

Learning Carbon

Name: Learning Carbon
Author: Apple Computer Inc
ISBN: 9780596001612

by Apple Computer Inc

May 2001

Intermediate to advanced

360 pages

10h 6m

English

O'Reilly Media, Inc.

Read now

Unlock full access

Learning Carbon
Preface
Why Carbon?
Who Might Find This Book Helpful
What You Need
What’s Up Ahead
Side Trips and Terms
Code
The Environment Could Change
How to Contact Us
1. Introduction to Carbon
Carbon and Mac OS X

What’s in Carbon?
Building Carbon Applications
The Carbon Factory Tour
The Starter KitThe Toolbox interfacesAquaBehind the curtainThe Expansion PackSpecialty InterfacesQuickTimeColor, images, and print production3D graphicsHTMLSpeechText and international servicesInternet and networkingSecurityLow-level tweakingUtility InterfacesLegacy Interfaces
Recap
2. Specifying a Carbon Application: Moon Travel Planner
The Moon Travel Planner WindowBehaviorImplementation
The Menu Bar
BehaviorImplementation
The About Window
BehaviorImplementation
The Facts for the Traveler Window
BehaviorImplementation
The Itinerary Window
BehaviorImplementation
Recap
3. Project Builder Projects
A Carbon Application ProjectFile ReferencesSourcesResourcesExternal frameworks and librariesProductsTargetsMain.c: A Skeletal ApplicationThings May Not Be Where You Think They AreApplication BundlesBuilding and Running a ProjectDebugging a ProjectOnscreen Documentation
Moon Travel Planner: Creating a Project
Building and Running the Skeletal Application
Recap
4. Interface Builder: Nibs and Windows
A Carbon Nib FileThe Default Items in a Nib FileInfo WindowsWindow ClassesTheme BrushControlsAttributesReceives
Moon Travel Planner: Modifying the Default Window
Open Interface BuilderRevise the Window TitleSet the Window Class, Controls, and AttributesSet the Window’s SizeBuild, Run, and Check the ApplicationRecap
5. Interface Builder: Toolsand Controls
Palettes and Layout ToolsThe Carbon Palettes WindowMenus paletteControls paletteEnhanced controls paletteData views paletteWindows paletteLayout Tools
Moon Travel Planner: Adding Objectsto the Main Window
Open the Nib FileAdd an Item from the Enhanced Controls PaletteAdd Items from the Controls PaletteAdd a PICT ResourceAlign Objects with the Layout ToolsCheck the InterfaceRecap
6. Carbon Events
Carbon Event HandlingEvent TargetsEvent TypesEvent ReferencesDefault Event HandlersDefining an Event HandlerInstalling an Event Handler
MoonTravel Planner: Writing an Event Handler
Identify EventsWrite the Main Window Event HandlerThe main window event handlerThe compute command handlerInstall the Main Window Event HandlerModify the main functionCall the Application Event Loop FunctionRecap
7. Interface Builder: Menus
The Menu BarApplication MenuFile MenuEdit MenuWindow MenuHelp MenuHierarchical MenusContextual Menus
Moon Travel Planner: Modifying the Menu Bar
Disable the Items You Won’t NeedSet Up the Items You Know You’ll NeedAdd an About commandAdd an Open Itinerary commandAdd Commands for Close and Save AsAdd Commands for Page Setup and PrintDelete the Help MenuAdd an Application-Specific Menu to the Menu BarAdd Code to Your ProjectCreate the menu barHandle menu commandsTest the MenusRecap
8. Text and Localization
Language-Specific FoldersInfoPlist.strings FileHelp FolderNib FilesLocalizable Strings Files
Moon Travel Planner: Displaying Localized Text
Create a New WindowAdd a Text FieldCreate Content for the WindowWrite a Function to Display the WindowAdding function and global declarationsCreating the windowWriting the show moon facts window functionModify the Main Window Event HandlerWrite a Handler for the Moon Facts WindowIdentify eventsWrite the code for the handlerInstall the moon facts window event handlerMake Sure the Text Displays ProperlyRecap
9. Printing
The Carbon Printing ManagerA Sample Printing SessionA look at the print loopError handlingSequence and Scope for Printing FunctionsData Types for Working with Printing SessionsFunctions for Working with Printing SessionsWhere to Go from Here
Moon Travel Planner: Adding Printing to the Moon Facts Window
Define Constants for Working with PrintingDefine Data Types for Working with PrintingDefine Prototypes for Printing FunctionsWrite Printing FunctionsMTPCreatePrintInfoForWindowMTPSetupPageFormatForPrintingMTPPageSetupDoneProcMTPDoPageSetupMTPPrintDialogDoneProcMTPDoPrintMTPDrawMoonFactsPageMTPPagesInDocMTPPostPrintingErrorsMTPDoPrintLoopAdd a Print Format String to the Localized StringsAdd Printing Code to the Main FunctionAdjust Code in the Moon FactsWindow Event HandlerTest the Page Setup and Print CommandsRecap
10. Property Lists
The Information Property List: Info.plistStandard KeysFinder KeysViewing and Modifying Property Lists in Project BuilderThe About Window
Moon Travel Planner: Modifying and Using Properties
Modify the Property ListCreate a New WindowCreate the About Window from the nib FileWrite a Function to Handle the About CommandWriting an Event Handler for the About WindowBuild, run, and test the applicationRecap
11. Files
Managing Files on the MacThe File ManagerFilesThe organization of the file systemThe Finder and the file systemThe volume formatIdentifying a fileFile accessFile sizeThe typical tasks of file managementCreating a new fileOpening a fileReading and writing dataNavigation ServicesThe programming modelThe navigation event handlerPersistenceThe Navigation Services dialogsStandard user interface elements in Navigation Services dialogsThe column view browserThe Where pop-up menuOpen dialogSave ChangesSave Location
Moon Travel Planner: Handling Files
Create a Window to Display the ItineraryDefine Constants and Variables for Creating Itinerary FilesWrite the Itinerary Window Event HandlerOpen an Itinerary FileConfigure and display an Open dialogRespond to the user’s actionRetrieve the file to openCreate a new itinerary windowRead the itinerary fileDisplay the itinerary textSave the ItineraryConfigure and display a Save dialogRespond to the user’s actionCreate the save fileWrite the save dataClose the ItineraryHandle the Open Command from the Main WindowBuild, Run, and Test the Application
Recap
12. Providing Help
Help on Mac OS XHelp Content for Help BooksGuidelines for creating help contentThe mechanics of creating help book contentAnchorsSegmentsDescriptionsKeywordsIndexingHelp TagsHow does a help tag work?Guidelines for writing help tags
Moon Travel Planner: Adding Help
Add the Help Book to the ProjectModify the Application’s Property ListRegister the Help BookAdd a Help TagMake Sure Help Works Properly
Recap
13. Desktop Icons
Icon BasicsTypes of IconsApplication iconsDocument iconsIcons for plug-ins and other support filesDesign TipsIcon Sizes and MasksAssigning Icons to Applications and FilesImporting icons into Icon ComposerRegister the Icon Composer file for the application iconAdding a Document Type to a ProjectGeneric file typesCustom file types
Moon Travel Planner: Adding Icons
Import Images to Icon ComposerAdd the Icon FilesRegister the Application Icon FileAdd a Document TypeMake Sure the Icons Display in the Finder
Recap
14. Beyond Moon Travel: Advanced Topics
Scriptable ApplicationsHow Scripting WorksMaking Your Application ScriptableDesign scripting in from the beginningIdentify the objects and commands you will supportCreate an ‘aete’ resource that describes your scripting supportWrite handlers for the Apple events you supportInstall your Apple event handlersProcess incoming Apple events
Threads and Multiprocessing
Multiprocessing Services in a Peanut Shell
Tab Controls
Add a Tab Control to a WindowAdd Controls to a User PaneWrite a Handler for the Tab Controls and Panes
Epilogue
A. Additional Resources
Building Your Mac OS X LibraryInside Mac OS X: System OverviewInside Mac OS X: Aqua Human Interface GuidelinesInside Carbon: Carbon Porting GuideDiscovering QuickTime
Tapping the Carbon Developer Community
Mac DevCenterMacTech MagazineThe MacDev-1 Email ListCarbon Development Email List
Keeping Current
Getting Sample Code
Registering Creator Codes
Partnering with Apple
B. Carbon Event Classesand Kinds
C. Parameter Names and Typesfor Common Event Kinds
Apple Events
Control Events
Command Events
Menu Events
Mouse Events
Text Input Events
Window Events
Index
Colophon

Content preview from Learning Carbon

Text Input Events

Text input events are generated in response to text input handled by the Text Services Manager. These events typically correspond to actions taken by a text input method, rather than raw keystrokes, although some of the parameters allow you to extract individual characters.

Table C-6. Required Parameter Names and Types for Text Input Event Kinds

Event kind	Parameter name	Parameter type
`kEventUpdateActiveInputArea`	`kEventParamTextInputSendComponentInstance`	`typeComponentInstance`
	`kEventParamTextInputSendRefCon`	`typeLongInteger`
	`kEventParamTextInputSendSLRec`	`typeIntlWritingCode`
	`kEventParamTextInputSendFixLen`	`typeLongInteger`
	`kEventParamTextInputSendText`	`typeUnicodeText` for a Unicode document; `typeChar` otherwise
`kEventUnicodeForKeyEvent`	`kEventParamTextInputSendComponentInstance`	`typeComponentInstance`
	`kEventParamTextInputSendRefCon`	`typeLongInteger`
	`kEventParamTextInputSendSLRec`	`typeIntlWritingCode`
	`kEventParamTextInputSendText`	`typeUnicodeText`
	`kEventParamTextInputSendKeyboardEvent`	`typeEventRef`
`kEventOffsetToPos`	`kEventParamTextInputSendComponentInstance`	`typeComponentInstance`
	`kEventParamTextInputSendRefCon`	`typeLongInteger`
	`kEventParamTextInputSendTextOffset`	`typeLongInteger`
	`kEventParamTextInputReplyPoint`	`typeQDPoint`
`kEventPosToOffset`	`kEventParamTextInputSendComponentInstance`	`typeComponentInstance`
	`kEventParamTextInputSendRefCon`	`typeLongInteger`
	`kEventParamTextInputSendCurrentPoint`	`typeQDPoint`
	`kEventParamTextInputReplyRegionClass ...`

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.

Julian F.

Head of Cybersecurity

I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.

Addison B.

Field Engineer

I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.

Amir M.

Data Platform Tech Lead

I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.

Mark W.

Embedded Software Engineer

Publisher Resources

ISBN: 0596001614Catalog Page Errata

Cloud Computing

Data Engineering

Data Science

AI & ML

Programming Languages

Software Architecture

IT/Ops

Security

Design

Business

Soft Skills

Learning Carbon

by Apple Computer Inc

Text Input Events

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.