Retired Document
Important: This sample code may not represent best practices for current development. The project may use deprecated symbols and illustrate technologies and techniques that are no longer recommended.
AppUsingSheets/Source/UIHandling.c
/* |
File: UIHandling.c |
Contains: Basic RunApplicationEventLoop-based UI handling, Carbon API. Originally |
based on the sample BasicRAEL supplied in the CarbonLib SDK. |
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple Computer, Inc. |
("Apple") in consideration of your agreement to the following terms, and your |
use, installation, modification or redistribution of this Apple software |
constitutes acceptance of these terms. If you do not agree with these terms, |
please do not use, install, modify or redistribute this Apple software. |
In consideration of your agreement to abide by the following terms, and subject |
to these terms, Apple grants you a personal, non-exclusive license, under AppleÕs |
copyrights in this original Apple software (the "Apple Software"), to use, |
reproduce, modify and redistribute the Apple Software, with or without |
modifications, in source and/or binary forms; provided that if you redistribute |
the Apple Software in its entirety and without modifications, you must retain |
this notice and the following text and disclaimers in all such redistributions of |
the Apple Software. Neither the name, trademarks, service marks or logos of |
Apple Computer, Inc. may be used to endorse or promote products derived from the |
Apple Software without specific prior written permission from Apple. Except as |
expressly stated in this notice, no other rights or licenses, express or implied, |
are granted by Apple herein, including but not limited to any patent rights that |
may be infringed by your derivative works or by other works in which the Apple |
Software may be incorporated. |
The Apple Software is provided by Apple on an "AS IS" basis. APPLE MAKES NO |
WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED |
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND OPERATION ALONE OR IN |
COMBINATION WITH YOUR PRODUCTS. |
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR |
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE |
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION |
OF THE APPLE SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT |
(INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN |
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
Copyright © 1999-2001 Apple Computer, Inc., All Rights Reserved |
*/ |
#include "MyCarbonPrinting.h" |
#include "AppDrawing.h" |
#include "NavServicesHandling.h" |
#include "UIHandling.h" |
#include "PDEHandling.h" |
#define kMyApplicationSignature 'DGPT' |
#define kMyPrintInfoProperty 'CGDT' |
static OSStatus Initialize(void); |
static pascal OSErr QuitAppleEventHandler(const AppleEvent *appleEvt, AppleEvent* reply, long refcon); |
static pascal OSStatus myWinEvtHndlr(EventHandlerCallRef myHandler, |
EventRef event, void* userData); |
static pascal OSStatus DoAppCommandProcess(EventHandlerCallRef nextHandler, |
EventRef theEvent, void* userData); |
static OSStatus InstallAppEvents(void); |
static void HandleWindowUpdate(WindowRef window, const void *dataP); |
static void DoAboutBox(void); |
static IBNibRef getOurNibRef(void); |
static OSStatus FixupMenus(void); |
int main(int argc, char* argv[]) |
{ |
#pragma unused (argc, argv) |
OSStatus err = noErr; |
IBNibRef nibRef = getOurNibRef(); |
if(nibRef){ |
// Once the nib reference is created, set the menu bar. "MainMenu" is the name of the menu bar |
// object. This name is set in InterfaceBuilder when the nib is created. |
err = SetMenuBarFromNib(nibRef, CFSTR("MenuBar")); |
require_noerr( err, CantSetMenuBar ); |
err = FixupMenus(); |
require_noerr( err, CantFixupMeus ); |
DrawMenuBar(); |
err = Initialize(); |
require_noerr( err, CantInitialize ); |
// open a document |
err = MakeNewDocument(); |
require_noerr( err, CantOpenDocument ); |
// Call the event loop |
RunApplicationEventLoop(); |
} |
CantFixupMeus: |
CantSetMenuBar: |
CantInitialize: |
CantOpenDocument: |
return err; |
} |
static IBNibRef getOurNibRef(void) |
{ |
/* the nibRef is a static local global and is only created the first |
time this routine is called but is needed repeatedly during the life |
of our application. getOurNibRef is an accessor for that data. |
*/ |
static IBNibRef nibRef = NULL; |
if(!nibRef){ |
/* Create a Nib reference passing the name of the nib file (without the .nib extension) |
CreateNibReference only searches into the application bundle. |
We need this nib for the life of our application |
*/ |
OSStatus err = CreateNibReference(CFSTR("main"), &nibRef); |
if(err) |
nibRef = NULL; |
} |
return nibRef; |
} |
static OSStatus FixupMenus(void) |
{ |
OSStatus err; |
long response; |
// see if we should modify quit in accordance with the Aqua HI guidelines |
err = Gestalt(gestaltMenuMgrAttr, &response); |
if ((err == noErr) && (response & gestaltMenuMgrAquaLayoutMask)) |
{ |
MenuRef fileMenu; |
MenuItemIndex outIndex; |
// find the file menu which contains the Quit command we want to remove |
err = GetIndMenuItemWithCommandID(NULL, kHICommandPrint, 1, &fileMenu, &outIndex); |
if(!err) |
err = GetIndMenuItemWithCommandID(fileMenu, kHICommandQuit, 1, &fileMenu, &outIndex); |
if(!err){ |
// remove the separator and the quit menu item |
DeleteMenuItem(fileMenu, outIndex); |
DeleteMenuItem(fileMenu, outIndex-1); |
} |
}else |
err = noErr; |
if(!err){ |
err = Gestalt(gestaltSystemVersion, &response); |
if(err != noErr || ((0x0000FFFF & response) < 0x1010)){ |
// we can't save as PDF unless we are executing on MacOS X v10.1 or later |
DisableMenuCommand(NULL, kHICommandSave); |
}else{ |
err = noErr; |
} |
} |
return err; |
} |
static OSStatus Initialize() |
{ |
OSErr err = noErr; |
InitCursor(); |
err = AEInstallEventHandler(kCoreEventClass, kAEQuitApplication, |
NewAEEventHandlerUPP(QuitAppleEventHandler), 0, FALSE); |
if (!err) |
err = InstallAppEvents(); |
return err; |
} |
WindowRef MakeWindow(const void *refCon) |
{ |
WindowRef window = NULL; // initialize to NULL |
OSStatus err = noErr; |
EventTypeSpec list[] = { |
{kEventClassWindow, kEventWindowClose }, |
{ kEventClassWindow, kEventWindowDrawContent }, |
{ kEventClassWindow, kEventWindowBoundsChanged } |
}; |
static EventHandlerUPP winEvtHandler = NULL; // window event handler |
// if we haven't already made our window event handler UPP then do so now |
if(!winEvtHandler){ |
winEvtHandler = NewEventHandlerUPP(myWinEvtHndlr); |
if(!winEvtHandler) |
err = memFullErr; |
} |
if(!err) |
err = CreateWindowFromNib(getOurNibRef(), CFSTR("Window"), &window); |
if(!err){ |
EventHandlerRef ref; |
err = InstallWindowEventHandler(window, winEvtHandler, |
sizeof(list)/sizeof(EventTypeSpec), list, NULL, &ref); |
// attach our document data to the window |
if(!err)err = SetWindowProperty(window, |
kMyApplicationSignature, kMyPrintInfoProperty, |
sizeof(refCon), |
&refCon); |
if(err){ |
DisposeWindow(window); |
window = NULL; |
} |
} |
return window; |
} |
static OSStatus InstallAppEvents(void) |
{ |
EventTypeSpec eventType; |
OSStatus err = noErr; |
EventHandlerUPP appCommandProcess = NewEventHandlerUPP(DoAppCommandProcess); // Command-process event handler |
if(appCommandProcess){ |
eventType.eventClass = kEventClassCommand; |
eventType.eventKind = kEventCommandProcess; |
InstallApplicationEventHandler(appCommandProcess, 1, &eventType, NULL, NULL); |
}else |
err = memFullErr; |
return err; |
} |
static pascal OSStatus myWinEvtHndlr(EventHandlerCallRef myHandler, |
EventRef event, void* userData) |
{ |
#pragma unused (myHandler, userData) |
WindowRef window; |
OSStatus result = eventNotHandledErr; |
GetEventParameter(event, kEventParamDirectObject, typeWindowRef, NULL, |
sizeof(window), NULL, &window); |
switch(GetEventKind(event)){ |
case kEventWindowDrawContent: |
{ |
void *ourDataP = GetOurWindowProperty(window); |
if(ourDataP){ |
HandleWindowUpdate(window, ourDataP); |
result = noErr; |
} |
} |
break; |
case kEventWindowBoundsChanged: |
{ |
Rect bounds; |
InvalWindowRect(window, GetWindowPortBounds(window, &bounds)); |
} |
break; |
case kEventWindowClose: |
(void)DisposeWindowPrivateData(GetOurWindowProperty(window)); |
DisposeWindow(window); |
result = noErr; |
break; |
default: |
break; |
} |
return result; |
} |
// Handle command-process events at the application level |
pascal OSStatus DoAppCommandProcess(EventHandlerCallRef nextHandler, |
EventRef theEvent, void* userData) |
{ |
#pragma unused (nextHandler, userData) |
HICommand aCommand; |
OSStatus result = eventNotHandledErr; |
GetEventParameter(theEvent, kEventParamDirectObject, typeHICommand, NULL, |
sizeof(HICommand), NULL, &aCommand); |
switch (aCommand.commandID) |
{ |
case kHICommandAbout: |
DoAboutBox(); |
result = noErr; |
break; |
case kHICommandNew: |
(void)MakeNewDocument(); |
result = noErr; |
break; |
case kHICommandSave: |
{ |
WindowRef w = FrontWindow(); |
void *ourDataP = GetOurWindowProperty(w); |
if(ourDataP){ |
(void)DoSaveAsPDF(w, ourDataP); |
result = noErr; |
} |
} |
break; |
case kHICommandPageSetup: |
{ |
WindowRef w = FrontWindow(); |
void *ourDataP = GetOurWindowProperty(w); |
if(ourDataP){ |
(void)DoPageSetup(w, ourDataP); |
result = noErr; |
} |
} |
break; |
case kHICommandPrint: |
{ |
WindowRef w = FrontWindow(); |
void *ourDataP = GetOurWindowProperty(w); |
if(ourDataP){ |
(void)DoPrint(w, ourDataP, kDoPrintWithPrintDialog); |
result = noErr; |
} |
} |
break; |
case kMyMenuCommandPrintOne: |
{ |
WindowRef w = FrontWindow(); |
void *ourDataP = GetOurWindowProperty(w); |
if(ourDataP){ |
(void)DoPrint(w, ourDataP, kDoPrintOne); |
result = noErr; |
} |
} |
break; |
case kHICommandQuit: |
QuitApplicationEventLoop(); |
result = noErr; |
break; |
default: |
break; |
} |
HiliteMenu(0); |
return result; |
} |
static void HandleWindowUpdate(WindowRef window, const void *ourPrivateDataP) |
{ |
if(ourPrivateDataP){ |
Rect bounds; |
PageDrawProc *drawProc = GetMyDrawPageProc(ourPrivateDataP); // get the draw proc |
CGrafPtr savePort; |
GetPort(&savePort); |
SetPortWindowPort(window); |
EraseRect(GetWindowPortBounds(window, &bounds)); |
// this code always draws page 1 on screen |
(void)drawProc(ourPrivateDataP, &bounds, 1); |
SetPort(savePort); |
} |
} |
static pascal OSErr QuitAppleEventHandler(const AppleEvent *appleEvt, |
AppleEvent* reply, long refcon) |
{ |
#pragma unused (appleEvt, reply, refcon) |
QuitApplicationEventLoop(); |
//#pragma noreturn (QuitAppleEventHandler) |
return 128; |
} |
void *GetOurWindowProperty(WindowRef window) |
{ |
void *ourDataP = NULL; |
if(window){ |
UInt32 infoSize = sizeof(void *); |
if(noErr != GetWindowProperty(window, |
kMyApplicationSignature, kMyPrintInfoProperty, |
infoSize, NULL, |
&ourDataP)) |
{ |
ourDataP = NULL; |
} |
} |
return ourDataP; |
} |
static void DoAboutBox() |
{ |
CFStringRef ourString = NULL; |
SInt16 alertItemHit = 0; |
Str255 stringBuf; |
/* |
If this code were Mac OS X only we could use CreateStandardAlert |
together with RunStandardAlert instead of having to get a |
Pascal string corresponding to our CFStringRef for use with |
Standard Alert |
*/ |
ourString = CFCopyLocalizedString(kAboutBoxStringKey, NULL); |
if (ourString != NULL) |
{ |
if (CFStringGetPascalString (ourString, stringBuf, |
sizeof(stringBuf), GetApplicationTextEncoding())) |
{ |
StandardAlert(kAlertStopAlert, stringBuf, NULL, NULL, &alertItemHit); |
} |
CFRelease (ourString); |
} |
} |
void DoErrorAlert(OSStatus status, CFStringRef errorFormatString) |
{ |
CFStringRef formatStr = NULL, printErrorMsg = NULL; |
SInt16 alertItemHit = 0; |
Str255 stringBuf; |
/* |
If this code were Mac OS X only we could use CreateStandardAlert |
together with RunStandardAlert instead of having to get a |
Pascal string corresponding to our CFStringRef for use with |
Standard Alert |
*/ |
if ((status != noErr) && (status != kPMCancel)) |
{ |
formatStr = CFCopyLocalizedString (errorFormatString, NULL); |
if (formatStr != NULL) |
{ |
printErrorMsg = CFStringCreateWithFormat( |
NULL, NULL, |
formatStr, status); |
if (printErrorMsg != NULL) |
{ |
if (CFStringGetPascalString (printErrorMsg, |
stringBuf, sizeof(stringBuf), |
GetApplicationTextEncoding())) |
{ |
StandardAlert(kAlertStopAlert, stringBuf, |
NULL, NULL, &alertItemHit); |
} |
CFRelease (printErrorMsg); |
} |
CFRelease (formatStr); |
} |
} |
} |
Copyright © 2003 Apple Computer, Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2003-01-14