TweetFollow Us on Twitter

Window Related Events
Volume Number:9
Issue Number:1
Column Tag:Getting Started

Related Info: Event Manager Window Manager

Window Related Events

Handling update, activate and suspend/resume events

By Dave Mark, MacTech Magazine Regular Contributing Author

Note: Source code files accompanying this article are located on MacTech CD-ROM or source code disks.

In last month’s column, we covered the basics of event loop programming, focusing on four specific events: the mouseDown, mouseUp, keyDown, and autoKey events. If you haven’t already, be sure to read through the Event Manager chapters in Inside Macintosh, Volumes I and VI. Pay specific attention to the sections that describe the mouseDown, mouseUp, keyDown, and autoKey events in detail. Finally, go back to last month’s program and flesh it out a little. When a mouseDown occurs, draw a string in the event window that describes where and when the mouseDown occurred. For a keyDown, draw the character and key codes embedded in the EventRecord.

In this month’s column, we’re going to expand our event handling repertoire, focusing on activate, update, and suspend/resume events.

Activate Events

Every time your application creates a window, that window is added to a list maintained by the Window Manager. The windows in this list are in the order that they appear on the screen, from the frontmost to the rearmost. The frontmost window is also known as the active window. In Figure 1, Window #1 starts off as the active window. Notice the difference between the title bars of the active and non-active window.

When the mouse is clicked in the rear window, Window #1 is made inactive, then the rear window, Window #2, is made active. Since the front window is made inactive before another window is brought to the front, there will never be more than one active window at a time!

The Window Manager accomplishes this by sending your application a series of activate events. If a rear window is being brought to the front, your application will receive two activate events. The first tells you that the frontmost window is becoming inactive. This event is also known as a deactivate event. The second event tells your application that a window is becoming active. Both of these events set EventRecord.what to activateEvt.

If a window is created, and there are no currently open windows, the Window Manager only generates a single activate event, indicating that the newly created window is becoming active. In this case, no deactivate event is sent.

Figure 1. A mouse click in Window #2 brings it to the front.

In general, you’ll use activate events if you treat window contents differently for an active window than for an inactive window. For example, your application might highlight selected text in the active window, but not in an inactive window. Activate events are provided for your benefit. Use them as you see fit. You’ll see how we discriminate between an activate and deactivate event when we get to our program later in the column.

Figure 2. When Window #1 is dragged to the left, more of Window #2 is exposed, causing an update event.

Update Events

Next on our list of events is an event that tells your program to update the contents of a window. The updateEvt is generated when a window is created (after the activateEvt is generated) and when a new portion of a window is revealed. Figure two shows a typical sequence that generates an updateEvt. The first picture shows Window #1 partially obscuring Window #2. Next, Window #1 is dragged to the left, revealing a previously hidden section of the Window #2. The Window Manager sends an updateEvt to your application, telling it to update the contents of Window #2. The third picture shows the window, after the program responded to the update event.

Figure 3 shows a slightly different sequence, involving update and activate events. This time, the mouse is clicked in Window #2, bringing it to the front. First, a deactivate event is generated for Window #1. Next, an activate event is generated for Window #2. Finally, an update event is generated, asking the program to update the contents of Window #2.

Once again, you’ll see update and activate events in action in the program later in the column.

Figure 3. When Window #2 is moved to the front, two activate events and an update event are generated.

Suspend/Resume Events

Under MultiFinder (System 6) and under System 7, more than one application is allowed to run at a time. When you click in a window belonging to a background application, the active application receives a suspend event, and the background application receives a resume event and is moved to the foreground.

You might use suspend and resume events to determine the actions taken by your program. For example, in the foreground, you might display a special tool palette, or perhaps run an animation. When your application moves into the background, you’ll receive a suspend event and you might hide the tool palette, or discontinue the animation until you get a resume event.

It’s important to note that your application can continue running, even if it receives a suspend event. It will still continue to receive update (and other appropriate events) while in the background. At the very least, it’s a good idea to treat a suspend event as you would a deactivate event when it comes to the contents of your windows. For example, if you usually deselect any selected text when a window is deactivated, do the same thing for the active window when you receive a suspend event.

At Last! The Program!

As promised, here’s a program that incorporates all the events described in this column. WindowMaster creates a single window and handles all the usual events relating to windows. Figure 4 shows the WindowMaster window in all its glory. Notice that this window sports a close box, a zoom box, a drag region (the title bar), and a grow box. Though this window doesn’t support scroll bars, there is room for them. In most cases, if a window has a grow box, it has room for scroll bars. We’ll get to scroll bars in a later column.

Figure 4. WindowMaster in action.

Creating the WindowMaster Resources

Create a folder in your development folder named WindowMaster. Launch ResEdit, then create a resource file named WindowMaster.Π.rsrc in your WindowMaster folder. You’ll create two resources in this file.

First, create a WIND resource according to the specifications in Figure 5. Next, select Set 'WIND' Characteristics... from the WIND menu and set the window’s title to PICT 128. Next, copy a graphic from your scrapbook into the clipboard. If you don’t have anything interesting in your scrapbook, go draw something. I’ll wait.

Figure 5. Specifications for WindowMaster’s WIND resource.

Once you’ve got a graphic in the clipboard, return to ResEdit and select Paste from the Edit menu. ResEdit will place your picture in a PICT resource. Make sure the PICT resource has a resource ID of 128. Well, that’s it for ResEdit. Quit, making sure you save your changes.

Creating the WindowMaster Project

Once you’re out of ResEdit, launch THINK C and create a new project file named WindowMaster.Π in the WindowMaster folder. Add MacTraps to the project file. Next, select New from the File menu and type this source code into the window that appears.

/* 1 */
#include <Values.h>

#define kBaseResID 128
#define kMoveToFront (WindowPtr)-1L
#define kSleep   MAXLONG

#define kScrollBarAdjust  (16-1)
#define kLeaveWhereItIs   false
#define kNormalUpdates    true

#define kMinWindowHeight  50
#define kMinWindowWidth   80

/*************/
/*  Globals  */
/*************/

Boolean gDone;

/***************/
/*  Functions  */
/***************/

void  ToolBoxInit( void );
void  WindowInit( void );
void  EventLoop( void );
void  DoEvent( EventRecord *eventPtr );
void  HandleMouseDown( EventRecord *eventPtr );
void  DoUpdate( EventRecord *eventPtr );
void  DoPicture( WindowPtr window, PicHandle picture );
void  DoActivate( WindowPtr window, Boolean becomingActive );
void  DoSuspendResume( Boolean resuming );
void  CenterPict( PicHandle picture, Rect *srcRectPtr,
 Rect *destRectPtr );


/******************************** main *********/

void  main( void )
{
 ToolBoxInit();
 WindowInit();
 
 EventLoop();
}

/*********************************** ToolBoxInit */

void  ToolBoxInit( void )
{
 InitGraf( &thePort );
 InitFonts();
 InitWindows();
 InitMenus();
 TEInit();
 InitDialogs( nil );
 InitCursor();
}

/******************************** WindowInit *********/

void  WindowInit( void )
{
 WindowPtrwindow;
 
 window = GetNewWindow( kBaseResID, nil, kMoveToFront );
 
 if ( window == nil )
 {
 SysBeep( 10 );  /*  Couldn't load the WIND resource!!!  */
 ExitToShell();
 }
 
 ShowWindow( window );
 SetPort( window );
}
/******************************** EventLoop *********/

void  EventLoop( void )
{
 EventRecordevent;
 
 gDone = false;
 while ( gDone == false )
 {
 if ( WaitNextEvent( everyEvent, &event, kSleep, nil ) )
 DoEvent( &event );
 }
}

/************************************* DoEvent      */

void  DoEvent( EventRecord *eventPtr )
{
 BooleanbecomingActive, resuming;
 
 switch ( eventPtr->what )
 {
 case mouseDown: 
 HandleMouseDown( eventPtr );
 break;
 case updateEvt:
 DoUpdate( eventPtr );
 break;
 case activateEvt:
 becomingActive = ( (eventPtr->modifiers & activeFlag)
 == activeFlag );
 DoActivate( (WindowPtr)eventPtr->message, 
 becomingActive );
 break;
 case osEvt:
 resuming = ( eventPtr->message & suspendResumeMessage )
 == resumeFlag;
 DoSuspendResume( resuming );
 break;
 }
}

/************************************* HandleMouseDown */

void  HandleMouseDown( EventRecord *eventPtr )
{
 WindowPtrwindow;
 short  thePart;
 GrafPtroldPort;
 long   windSize;
 Rect   growRect;
 
 thePart = FindWindow( eventPtr->where, &window );
 
 switch ( thePart )
 {
 case inSysWindow : 
 SystemClick( eventPtr, window );
 break;
 case inContent:
 SelectWindow( window );
 break;
 case inDrag : 
 DragWindow( window, eventPtr->where, 
 &screenBits.bounds );
 break;
 case inGoAway :
 if ( TrackGoAway( window, eventPtr->where ) )
 gDone = true;
 break;
 case inGrow:
 growRect.top = kMinWindowHeight;
 growRect.left = kMinWindowWidth;
 growRect.bottom = MAXSHORT;
 growRect.right = MAXSHORT;
 
 windSize = GrowWindow( window, eventPtr->where, 
 &growRect );
 if ( windSize != 0 )
 {
 GetPort( &oldPort );
 SetPort( window );
 EraseRect( &window->portRect );
 SizeWindow( window, LoWord( windSize ),
 HiWord( windSize ), kNormalUpdates );
 InvalRect( &window->portRect );
 SetPort( oldPort );
 }
 break;
 case inZoomIn:
 case inZoomOut:
 if ( TrackBox( window, eventPtr->where, thePart ) )
 {
 GetPort( &oldPort );
 SetPort( window );
 EraseRect( &window->portRect );
 ZoomWindow( window, thePart, kLeaveWhereItIs );
 InvalRect( &window->portRect );
 SetPort( oldPort );
 }
 break;
 }
}

/************************************* DoUpdate     */

void  DoUpdate( EventRecord *eventPtr )
{
 short  pictureID;
 PicHandlepicture;
 WindowPtrwindow;
 
 window = (WindowPtr)eventPtr->message;
 
 BeginUpdate( window );
 
 picture = GetPicture( kBaseResID );
 
 if ( picture == nil )
 {
 SysBeep( 10 );  /*  Couldn't load the PICT resource!!!  */
 ExitToShell();
 }
 
 DoPicture( window, picture );
 
 EndUpdate( window );
}

/******************************** DoPicture *********/

void  DoPicture( WindowPtr window, PicHandle picture )
{
 Rect   drawingClipRect, destRect;
 RgnHandletempRgn;
 
 SetPort( window );
 
 EraseRect( &window->portRect );
 
 tempRgn = NewRgn();
 GetClip( tempRgn );

 drawingClipRect = window->portRect;
 drawingClipRect.right -= kScrollBarAdjust;
 drawingClipRect.bottom -= kScrollBarAdjust;
 
 ClipRect( &drawingClipRect );
 
 CenterPict( picture, &drawingClipRect, &destRect );
 DrawPicture( picture, &destRect );
 
 SetClip( tempRgn );
 DisposeRgn( tempRgn );
 
 DrawGrowIcon( window );
}

/************************************* DoActivate   */



void  DoActivate( WindowPtr window, Boolean becomingActive )
{
 DrawGrowIcon( window );
}

/************************************* DoSuspendResume    */

void  DoSuspendResume( Boolean resuming )
{
 WindowPtrwindow;
 
 window = FrontWindow();
 
 DrawGrowIcon( window );
}

/****************** CenterPict ********************/

void  CenterPict( PicHandle picture, Rect *srcRectPtr,
 Rect *destRectPtr )
{
 Rect pictRect;
 
 pictRect = (**( picture )).picFrame;
 
 OffsetRect( &pictRect, srcRectPtr->left - pictRect.left,
    srcRectPtr->top - pictRect.top);
 OffsetRect( &pictRect,
 (srcRectPtr->right - pictRect.right)/2,
 (srcRectPtr->bottom - pictRect.bottom)/2);
 
 *destRectPtr = pictRect;
}

Once your code is typed in, save it under the name WindowMaster.c, then add the window to the project by selecting Add from the Project menu.

Running WindowMaster

Select Run from the Project menu to run WindowMaster. A single window, like the one shown in Figure 4 should appear. Click the mouse in the title bar and drag the window around on the screen. Next, click in the grow box and resize the window. Try making it tall and skinny, then short and fat. Notice that there is a limit to how small you can make the window. Next, click on the zoom box in the upper-right corner of the window. The window should expand to fill the main screen. Click the zoom-box again to return the window to its previous size.

Next, drag the window downwards, so it is halfway off the screen, obscuring part of the picture. Now drag it back up. The picture will be redrawn in full. Finally, click in the window’s close box to exit the program.

Walking Through the Source Code

Just like last month’s program, WindowMaster is based on an event loop architecture. Also, like last month’s column, the program starts off by including <Values.h> to get the constant MAXLONG, used for the #define kSleep. The #defines will be explained as they are used.

/* 2 */
#include <Values.h>

#define kBaseResID 128
#define kMoveToFront (WindowPtr)-1L
#define kSleep   MAXLONG

#define kScrollBarAdjust  (16-1)
#define kLeaveWhereItIs   false
#define kNormalUpdates    true

#define kMinWindowHeight  50
#define kMinWindowWidth   80

gDone is initialized to false, then set to true when a click occurs in the window’s close box. Note that this is not the way Mac applications normally exit, but we haven’t got to menus yet, so a click in the close box will have to do for now.

/* 3 */
Boolean gDone;

As always, the code includes prototypes for all functions.

/* 4 */
void  ToolBoxInit( void );
void  WindowInit( void );
void  EventLoop( void );
void  DoEvent( EventRecord *eventPtr );
void  HandleMouseDown( EventRecord *eventPtr );
void  DoUpdate( EventRecord *eventPtr );
void  DoPicture( WindowPtr window, PicHandle picture );
void  DoActivate( WindowPtr window, Boolean becomingActive );
void  DoSuspendResume( Boolean resuming );
void  CenterPict( PicHandle picture, Rect *srcRectPtr,
 Rect *destRectPtr );

main() initializes the Toolbox, creates a window, then enters the main event loop.

/* 5*/
/******************************** main *********/

void  main( void )
{
 ToolBoxInit();
 WindowInit();
 
 EventLoop();
}

ToolBoxInit() is the same as it ever was.

/* 6 */
/*********************************** ToolBoxInit */

void  ToolBoxInit( void )
{
 InitGraf( &thePort );
 InitFonts();
 InitWindows();
 InitMenus();
 TEInit();
 InitDialogs( nil );
 InitCursor();
}

WindowInit() calls GetNewWindow() to load the WIND resource from the resource file.

/* 7 */
/******************************** WindowInit *********/

void  WindowInit( void )
{
 WindowPtrwindow;
 
 window = GetNewWindow( kBaseResID, nil, kMoveToFront );

If the resource wasn’t found, beep once, then exit.

/* 8 */
 if ( window == nil )
 {
 SysBeep( 10 );  /*  Couldn't load the WIND resource!!!  */
 ExitToShell();
 }

Once the window is created, make it visible, then make it the current port. Notice that this routine does not do any drawing. We’ll draw our picture in response to an update event.

/* 9 */
 ShowWindow( window );
 SetPort( window );
}

EventLoop() sets gDone to false, then loops around a call to WaitNextEvent(). If WaitNextEvent() returns true, the event is passed to DoEvent().

/* 10 */
/******************************** EventLoop *********/

void  EventLoop( void )
{
 EventRecordevent;
 
 gDone = false;
 while ( gDone == false )
 {
 if ( WaitNextEvent( everyEvent, &event, kSleep, nil ) )
 DoEvent( &event );
 }
}
DoEvent() switches on the event’s what field.

/************************************* DoEvent      */

void  DoEvent( EventRecord *eventPtr )
{
 BooleanbecomingActive, resuming;
 
 switch ( eventPtr->what )
 {

A mouseDown event is passed to HandleMouseDown(). An updateEvt is passed on to DoUpdate().

/* 11 */
 case mouseDown: 
 HandleMouseDown( eventPtr );
 break;
 case updateEvt:
 DoUpdate( eventPtr );
 break;

In the case of an activate event, the event’s modifiers field holds the key to whether the event is an activate or deactivate event. activeFlag is a mask that designates one of the bits in the modifiers field. If the bit is set, the event is an activate event. If the bit is clear, the event is a deactivate event. The Boolean becomingActive is true if the event is an activate event. Once becomingActive is set, it is passed on to DoActivate(). The event’s message field holds a pointer to the window being activated or deactivated.

/* 12 */
 case activateEvt:
 becomingActive = ( (eventPtr->modifiers & activeFlag)
 == activeFlag );
 DoActivate( (WindowPtr)eventPtr->message,
 becomingActive );
 break;

Similarly, an osEvt is used to indicate either a suspend or resume event. suspendResumeMessage is a predefined constant that designates the suspend/resume bit in the message field. resuming is set to true if the event is a resume event. Once set, resuming is passed on to DoSuspendResume().

/* 13 */
 case osEvt:
 resuming = ( eventPtr->message & suspendResumeMessage )
 == resumeFlag;
 DoSuspendResume( resuming );
 break;
 }
}

HandleMouseDown() handles the mouseDown event.

/* 14 */
/************************************* HandleMouseDown */

void  HandleMouseDown( EventRecord *eventPtr )
{
 WindowPtrwindow;
 short  thePart;
 GrafPtroldPort;
 long   windSize;
 Rect   growRect;

FindWindow() takes the event’s where field and returns the window at those coordinates. thePart indicates the part of the window the mouse click occurred in.

/* 15 */
 thePart = FindWindow( eventPtr->where, &window );

If the click was in a portion of the screen not belonging to our application (like a desk accessory window), thePart is set to inSysWindow and we’ll pass the event back to the system with SystemClick().

/* 16 */
 switch ( thePart )
 {
 case inSysWindow : 
 SystemClick( eventPtr, window );
 break;

If the event was in the content region of the window, we’ll typically call SelectWindow() to bring the window to the front. Since we only have one window, this line isn’t particularly useful. Later on though, you’ll add another window to this program and you’ll want to keep this code in here.

As your windows get more complex, you’ll want to do more with inContent clicks than just select the window. You might have a button or scroll bar in the window that needs action, or you might have some text that needs selection. This is the jumping off point for all clicks that occur in the window. Eventually, we’ll add a routine named DoContentClick() to process clicks in a window’s content region.

/* 17 */
 case inContent:
 SelectWindow( window );
 break;

If the click was in the window’s drag region (title bar), we’ll pass the window (retrieved by FindWindow()), and the mouse click coordinates to the Toolbox routine DragWindow(). The third parameter is a bounding rectangle that determines where on the screen the window may be dragged. screenBits.bounds is a System global variable that defines the boundaries of the main display.

If you have two monitors, this code works fine, however. DragWindow() checks for screenBits.bounds as a parameter and, if it finds it, allows dragging anywhere on any monitor attached to the system.

/* 18 */
 case inDrag : 
 DragWindow( window, eventPtr->where, 
 &screenBits.bounds );
 break;

If the mouseDown was in the close box, we’ll call TrackGoAway() to see if the mouse was released while still inside the close box. If so, gDone is set to true. TrackGoAway() is the routine that does the little animation in the close box.

/* 19 */
 case inGoAway :
 if ( TrackGoAway( window, eventPtr->where ) )
 gDone = true;
 break;

If the click was in the grow box, we set up a rectangle that defines how large and how small the window is allowed to grow [See Inside Macintosh, Vol. 1 - Tech Ed.]. Basically, it’s good policy to put a limit on how small a window can get, but, unless you’ve got a pressing reason, you should allow windows to get as large as the user wants.

/* 20 */
 case inGrow:
 growRect.top = kMinWindowHeight;
 growRect.left = kMinWindowWidth;
 growRect.bottom = MAXSHORT;
 growRect.right = MAXSHORT;

Next, this rectangle is passed on to GrowWindow(), which tracks the mouse, allowing the user to specify the new window size.

/* 21 */
 windSize = GrowWindow( window, eventPtr->where, &growRect );

The return value contains two 2-byte values, indicating the new height and width of the window [Both zero means no change - Tech Ed.].

/* 22 */
 if ( windSize != 0 )
 {

First, we’ll save away the current port (in case it’s not this window), then make this window the current port. Next, we erase the entire window and change the window’s size by calling SizeWindow(). The last parameter tells the system we want this resizing to generate an update event.

/* 23 */
 GetPort( &oldPort );
 SetPort( window );
 EraseRect( &window->portRect );
 SizeWindow( window, LoWord( windSize ),
 HiWord( windSize ), kNormalUpdates );

Next, we call InvalRect() to tell the system that the entire window should be redrawn with the next update event, not just the new area revealed by the grow box. In fact, this call will force an update even if the window was shrunk.

/* 24 */
 InvalRect( &window->portRect );

Because we center our picture in the window, we need to redraw the window contents whenever the window changes size. To see why this is true, try commenting out the previous line of code.

Update events are tricky. It is definitely worth reading the section of Inside Macintosh that covers the Window Manager. You might also check out Chapter 4’s Updater program in Volume I of the Mac Primer.

Once the window is resized, the port is set back to its old value. Since InvalRect() applies to the current port, it was important that we make the window being grown the current port.

/* 25 */
 SetPort( oldPort );
 }
 break;

Finally, a click in the zoom box follows a similar strategy. Again, TrackBox() is called to verify that the mouse was released inside the zoom box. If so, ZoomWindow() is called to zoom the window, or return it to its old position, depending on its current state.

/* 26 */
 case inZoomIn:
 case inZoomOut:
 if ( TrackBox( window, eventPtr->where, thePart ) )
 {
 GetPort( &oldPort );
 SetPort( window );
 EraseRect( &window->portRect );
 ZoomWindow( window, thePart, kLeaveWhereItIs );
 InvalRect( &window->portRect );
 SetPort( oldPort );
 }
 break;
 }
}

DoUpdate() is called whenever an update event occurs. First, the window is retrieved from the event’s message field. Next, BeginUpdate() is called, telling the Window Manager that we’re handling updates for this window. BeginUpdate() will restrict drawing to the region of the window that needs updating, also known as the update region. If you call InvalRect() on the whole window, the whole window is available for drawing.

/* 27 */
/************************************* DoUpdate     */

void  DoUpdate( EventRecord *eventPtr )
{
 short  pictureID;
 PicHandlepicture;
 WindowPtrwindow;
 
 window = (WindowPtr)eventPtr->message;
 
 BeginUpdate( window );

Next, we load the picture and pass it on to DoPicture().

/* 28 */
 picture = GetPicture( kBaseResID );
 
 if ( picture == nil )
 {
 SysBeep( 10 );  /*  Couldn't load the PICT resource!!!  */
 ExitToShell();
 }
 
 DoPicture( window, picture );
 
 EndUpdate( window );
}

DoPicture() makes the window the current port, then erases the entire window. Note that this will already have been done if the update event was caused by a resize or zoom, but there’s no harm in this minor duplication of code.

/* 29 */

/******************************** DoPicture *********/

void  DoPicture( WindowPtr window, PicHandle picture )
{
 Rect   drawingClipRect, destRect;
 RgnHandletempRgn;
 
 SetPort( window );
 
 EraseRect( &window->portRect );

Next, a new region is created. We pass this region handle on to GetClip(), which places a copy of the window’s clipping region in tempRgn. The clipping region defines which parts of the window can be drawn in and which parts can’t. Again, it is a good idea to read the entire Window Manager chapter in Inside Macintosh, as there’s not enough space to cover all of it in this column.

/* 30 */
 tempRgn = NewRgn();
 GetClip( tempRgn );

Since we want to center the picture in the part of the window not covered by the grow region and scroll bar areas, we’ll subtract those areas from the window’s portRect. Next, we’ll pass this rectangle on to ClipRect() making it the new clip region.

/* 31 */
 drawingClipRect = window->portRect;
 drawingClipRect.right -= kScrollBarAdjust;
 drawingClipRect.bottom -= kScrollBarAdjust;
 
 ClipRect( &drawingClipRect );

Next, we’ll call CenterPict() to center the picture in drawingClipRect, returning the rectangle the picture should be drawn in as its third parameter. We then draw the picture with DrawPicture().

/* 32 */
 CenterPict( picture, &drawingClipRect, &destRect );
 DrawPicture( picture, &destRect );

Next, the clipping region is set back to its old value and the grow icon is redrawn, completing our update.

/* 33 */
 SetClip( tempRgn );
 DisposeRgn( tempRgn );
 
 DrawGrowIcon( window );
}

It’s important to remember that your application can receive update events even if it’s running in the background. If a foreground application’s window covers your application’s windows and is then moved, the Window Manager will send your application update events asking you to redraw the effected windows.

DoActivate() is pretty simple. It redraws the grow icon in the specified window. DrawGrowIcon() will draw a different grow icon, depending on whether your window is frontmost or not. When your application starts handling more than one window, you’ll start making use of the second parameter, becomingActive.

/* 34 */

/************************************* DoActivate   */

void  DoActivate( WindowPtr window, Boolean becomingActive )
{
 DrawGrowIcon( window );
}

DoSuspendResume() is also pretty simple. This time the frontmost window’s grow icon is redrawn. A front window, which has been suspended gets the same grow icon as any other window. DrawGrowIcon() is smart enough to know the state of your application.

Once again, as your programs get more complex, you’ll make use of the second parameter, resuming.

/* 35 */
/************************************* DoSuspendResume    */

void  DoSuspendResume( Boolean resuming )
{
 WindowPtrwindow;
 
 window = FrontWindow();
 
 DrawGrowIcon( window );
}

CenterPict() centers the picture in the rectangle pointed to by srcRectPtr, returning the result in the rectangle pointed to by destRectPtr.


/* 36 */
/****************** CenterPict ********************/

void  CenterPict( PicHandle picture, Rect *srcRectPtr,
 Rect *destRectPtr )
{
 Rect pictRect;
 
 pictRect = (**( picture )).picFrame;
 
 OffsetRect( &pictRect, srcRectPtr->left - pictRect.left,
    srcRectPtr->top - pictRect.top);
 OffsetRect( &pictRect,
 (srcRectPtr->right - pictRect.right)/2,
 (srcRectPtr->bottom - pictRect.bottom)/2);
   
 *destRectPtr = pictRect;
}

Till Next Month

There’s a lot going on in this program. As I’ve said before, do yourself a favor and read the Window Manager chapter in Inside Macintosh. If a concept in this program seems fuzzy, try commenting out some of the code to see what happens. This is especially useful with the code that effects or handles update events. You might also try commenting out the calls to DrawGrowIcon() just to see what happens.

Finally, try adding another window to the program. Add a second WIND and a second PICT resource to the resource file, then create the new window in WindowInit(). You’ll be amazed how easy it is to add a second window. Go ahead, try it!

By the way, you may have noticed that this month’s program comes in C only. Sorry Pascal fans, but the programs (and this column) are just getting too big and I had to choose one language or the other. Hopefully, you now have enough examples of C and Pascal that you’ll be able to either come up to speed on C (my preference) or translate the code to Pascal yourself.

By the way, for those of you following Daniel’s career, he’s getting big (would you believe he’s already 16 pounds, and he’s only 12 weeks old!), and he smiles an awful lot. Till next month, keep programming and Happy Holidays!!!

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

OS X Server 4.1.3 - For OS X 10.10 Yosem...
Designed for OS X and iOS devices, OS X Server makes it easy to share files, schedule meetings, synchronize contacts, develop software, host your own website, publish wikis, configure Mac, iPhone,... Read more
pwSafe 4.1 - Secure password management...
pwSafe provides simple and secure password management across devices and computers. pwSafe uses iCloud to keep your password databases backed-up and synced between Macs and iOS devices. It is... Read more
Kodi 15.0.rc1 - Powerful media center to...
Kodi (was XBMC) is an award-winning free and open-source (GPL) software media player and entertainment hub that can be installed on Linux, OS X, Windows, iOS, and Android, featuring a 10-foot user... Read more
Coda 2.5.11 - One-window Web development...
Coda is a powerful Web editor that puts everything in one place. An editor. Terminal. CSS. Files. With Coda 2, we went beyond expectations. With loads of new, much-requested features, a few surprises... Read more
Bookends 12.5.7 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Access the power of Bookends directly from Mellel, Nisus Writer Pro, or MS Word (... Read more
Maya 2016 - Professional 3D modeling and...
Maya is an award-winning software and powerful, integrated 3D modeling, animation, visual effects, and rendering solution. Because Maya is based on an open architecture, all your work can be scripted... Read more
RapidWeaver 6.2.3 - Create template-base...
RapidWeaver is a next-generation Web design application to help you easily create professional-looking Web sites in minutes. No knowledge of complex code is required, RapidWeaver will take care of... Read more
MacFamilyTree 7.5.2 - Create and explore...
MacFamilyTree gives genealogy a facelift: it's modern, interactive, incredibly fast, and easy to use. We're convinced that generations of chroniclers would have loved to trade in their genealogy... Read more
Paragraphs 1.0.1 - Writing tool just for...
Paragraphs is an app just for writers. It was built for one thing and one thing only: writing. It gives you everything you need to create brilliant prose and does away with the rest. Everything in... Read more
BlueStacks App Player 0.9.21 - Run Andro...
BlueStacks App Player lets you run your Android apps fast and fullscreen on your Mac. Version 0.9.21: Note: Now requires OS X 10.8 or later running on a 64-bit Intel processor. Initial stable... Read more

Rage of Bahamut is Giving Almost All of...
The App Store isn't what it used to be back in 2012, so it's not unexpected to see some games changing their structures with the times. Now we can add Rage of Bahamut to that list with the recent announcement that the game is severely cutting back... | Read more »
Adventures of Pip (Games)
Adventures of Pip 1.0 Device: iOS iPhone Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: ** ONE WEEK ONLY — 66% OFF! *** “Adventures of Pip is a delightful little platformer full of charm, challenge and impeccable... | Read more »
Divide By Sheep - Tips, Tricks, and Stre...
Who would have thought splitting up sheep could be so involved? Anyone who’s played Divide by Sheep, that’s who! While we’re not about to give you complete solutions to everything (because that’s just cheating), we will happily give you some... | Read more »
NaturalMotion and Zynga Have Started Tea...
An official sequel to 2012's CSR Racing is officially on the way, with Zynga and NaturalMotion releasing a short teaser trailer to get everyone excited. Well, as excited as one can get from a trailer with no gameplay footage, anyway. [Read more] | Read more »
Grab a Friend and Pick up Overkill 3, Be...
Overkill 3 is a pretty enjoyable third-person shooter that was sort of begging for some online multiplayer. Fortunately the begging can stop, because its newest update has added an online co-op mode. [Read more] | Read more »
Scanner Pro's Newest Update Adds Au...
Scanner Pro is one of the most popular document scanning apps on iOS, thanks in no small part to its near-constant updates, I'm sure. Now we're up to update number six, and it adds some pretty handy new features. [Read more] | Read more »
Heroki (Games)
Heroki 1.0 Device: iOS Universal Category: Games Price: $7.99, Version: 1.0 (iTunes) Description: CLEAR THE SKIES FOR A NEW HERO!The peaceful sky village of Levantia is in danger! The dastardly Dr. N. Forchin and his accomplice,... | Read more »
Wars of the Roses (Games)
Wars of the Roses 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: | Read more »
TapMon Battle (Games)
TapMon Battle 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: It's time to battle!Tap! Tap! Tap! Try tap a egg to hatch a Tapmon!Do a battle with another tapmons using your hatched tapmons! *... | Read more »
Alchemic Dungeons (Games)
Alchemic Dungeons 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: ### Release Event! ### 2.99$->0.99$ for limited time! ### Roguelike Role Playing Game! ### Alchemic Dungeons is roguelike... | Read more »

Price Scanner via MacPrices.net

Seagate Backup Plus Drives Feature 200GB of C...
Seagate Technology plc has announced that its Backup Plus family of external storage offerings will now include 200GB of OneDrive cloud storage, a major added value, and the addition of Lyve’s photo... Read more
Canon PIXMA MG3620 Wireless Inkjet All-in-One...
Canon U.S.A., Inc. has announced the PIXMA MG3620 Wireless (1) Inkjet All-in-One (AIO) printer for high-quality photo and document printing. Built with convenience in mind for the everyday home user... Read more
July 4th Holiday Weekend 13-inch MacBook Pro...
Save up to $150 on the purchase of a new 2015 13″ Retina MacBook Pro at the following resellers this weekend. Shipping is free with each model: 2.7GHz/128GB MSRP $1299 2.7GHz/... Read more
27-inch 3.5GHz 5K iMac on sale for $2149, sav...
Best Buy has the 27″ 3.5GHz 5K iMac on sale for $2149.99. Choose free shipping or free local store pickup (if available). Sale price for online orders only, in-store prices may vary. Their price is $... Read more
Apple now offering refurbished 2015 11-inch...
The Apple Store is now offering Apple Certified Refurbished 2015 11″ MacBook Airs as well as 13″ MacBook Airs (the latest models), available for up to $180 off the cost of new models. An Apple one-... Read more
15-inch 2.5GHz Retina MacBook Pro on sale for...
Amazon.com has the 15″ 2.5GHz Retina MacBook Pro on sale for $2274 including free shipping. Their price is $225 off MSRP, and it’s the lowest price available for this model. Read more
Finally Safe To Upgrade To Yosemite’?
The reason I’ve held back from upgrading my MacBook Air from OS X 10.9 Mavericks to 10.10 Yosemite for nearly a year isn’t just procrastination. Among other bugs reported, there have been persistent... Read more
Logo Pop Free Vector Logo Design App For OS X...
128bit Technologies has released of Logo Pop Free 1.2 for Mac OS X, a vector based, full-fledged, logo design app available exclusively on the Mac App Store for the agreeable price of absolutely free... Read more
21-inch 1.4GHz iMac on sale for $999, save $1...
B&H Photo has new 21″ 1.4GHz iMac on sale for $999 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Best Buy has the 21″ 1.4GHz iMac on sale for $999.99 on their... Read more
16GB iPad mini 3 on sale for $339, save $60
B&H Photo has the 16GB iPad mini 3 WiFi on sale for $339 including free shipping plus NY tax only. Their price is $60 off MSRP. Read more

Jobs Board

Mobile Payments Counsel, *Apple* Pay (digit...
**Job Summary** Apple is looking for an atto ey to join Apple 's Legal Department to support Apple Pay. **Key Qualifications** 4+ years of relevant experience Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** The ASC is an Apple employee who serves as the Apple business manager and influencer in a hyper-business critical Reseller's store which delivers Read more
Partner Marketing Manager, Merchant- *Apple*...
**Job Summary** The Apple Pay partner marketing team is looking for a marketing manager to develop and drive US marketing programs with our merchant partners. The right Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
Program Manger, WW *Apple* Direct Fulfillme...
**Job Summary** We are seeking a business analyst to work within our Worldwide Apple Direct Fulfillment Operations team. This role will work closely with related program Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.