TweetFollow Us on Twitter

Jun 97 - Macintosh Q and A

Volume Number: 13 (1997)
Issue Number: 6
Column Tag: develop

Macintosh Q&A

by Apple Developer Support Center

Q: When I used CopyBits to do a screen capture, the cursor isn't included. Why not?

A: CopyBits calls ShieldCursor to hide the cursor before it does its work. That's why you never see the cursor in your screen capture. The following code hides the cursor and decrements the cursor count in the low-memory global to fool CopyBits not to call ShieldCursor. Standard warning: Using low-memory globals is dangerous and is subject to future OS changes.

unsigned char   oldCrsrVis;
short           oldCrsrState;
      
// Hide the cursor.
oldCrsrVis = GetCrsrVis();
oldCrsrState = GetCrsrState();
SetCrsrVis((unsigned char) 0);
SetCrsrState(oldCrsrState - 1);   
// Do the screen capture.
CopyBits(...)
      
// Restore the old cursor.
SetCrsrState(oldCrsrState);
SetCrsrVis(oldCrsrVis);

You should define the cursor functions as follows:

enum {
   CrsrVis = 0x8CC,      // Cursor visible? [byte]
   CrsrState = 0x8D0      // Cursor nesting level [word]
};
   
void SetCrsrVis(unsigned char cursorVisible)   
{
   *(unsigned char*)CrsrVis = cursorVisible;
}

unsigned char GetCrsrVis(void)
{
   return ( *(unsigned char*)CrsrVis );
}   

short GetCrsrState(void)
{
   return ( *(unsigned char*)CrsrState );
}   

void SetCrsrState(short val)
{
   *(unsigned char*)CrsrState = val;
}

Q: How can I determine whether the cursor is hidden?

A: Currently the best way to determine this is to use a low-memory global that has been removed from LowMem.h. The reason it has been removed is that a future operating system may handle it differently.

Using low-memory globals has never really been sanctioned, though they were documented in older interface files. The Universal Interfaces were designed to make way for future operating systems; access to some low-memory globals was provided through accessor functions for safety, while access to others was removed.

The global you want, CrsrVis, is a byte-sized flag that tells whether the cursor is hidden. It was defined in an older interface file like this:

enum {
   CrsrVis = 0x8CC,   // Cursor visible? [byte]
};

You can simply check this global to see if the cursor is hidden. As always, the direct use of low-memory globals is not recommended and will probably cause your code to break in the future.


Q: I want to support dragging from my application to the Trash without having the Finder create a clipping file inside the Trash. I tried several options but they all failed. Is this possible?

A: There is no good way to prevent a clipping file from being created in the Trash, or to prevent the "zoomback" animation that signals a failed drag. The problem is that the Finder treats the Trash like a folder; the drag succeeds or fails according to the user's supposed intent with respect to a folder.

In our opinion, however, this is good, since it's consistent with the Trash metaphor. When the user drags an icon from a Finder window into the Trash, she expects the Trash to get fat so that she can later change her mind, open the Trash, and drag the icon back out. Creating a clipping file in the Trash merely extends the metaphor. The only problem this might cause is that the user ought to be able to reverse her decision and drag the clipping back into the application. If your application doesn't already support this action, you may have some work ahead.

We realize that other applications manage to avoid making the Trash fat. This is, in our opinion, a Bad Thing. A Hack. Wrong. Nevertheless, if you still feel you need to avoid making the Trash fat, it might be possible to do so. It would probably involve creating a file via flavorTypePromiseHFS, then deleting it before the Finder has a chance to make the Trash fat. Unfortunately, since this involves "fooling" the Finder, it isn't likely to work for future versions of the Finder even if it does work today.

In short, this is not recommended.


Q: When my application calls TrackDrag, it crashes in low memory at an illegal instruction. The MacsBug stack crawl doesn't produce any useful information. I've stared and stared at my application's calls to the Drag Manager, and all the parameters appear to be valid. My drag tracking handler is never called, incidentally. If I take all calls to the Drag Manager out of my application, it runs just fine. I've been investigating this crash for two months. Why is life so cruel?

A: You've unearthed a really ugly problem. The Drag Manager thinks the drag originated in the Finder, and makes some fatal assumptions based on that.

Early versions of the Drag Manager did not enjoy the benefits of a drag-enabled Finder, so the Drag Manager plays a little fast and loose with the Finder's jump table. Yes, that means what it sounds like: the Drag Manager calls the Finder routines through its jump table.

The even more interesting story concerns the method by which the Drag Manager decides that the current application is the Finder. When TrackDrag is called, the Drag Manager determines whether the drag originates in any of the windows in the window list of the current process. If not, the Drag Manager determines whether the drag originates in any Finder window. Since the desktop is a "window" for these purposes, there's a large area that qualifies.

Once the Drag Manager has decided the drag originated in a Finder window, it assumes that the Finder is the current process. (This is the fatal mistake.) Once this assumption is made, the next thing for the Drag Manager to do to coax the Finder into exhibiting the correct drag behavior is call an entry in whatever jump table can be found by offsetting the current value of register A5. This is valid if the Finder is the current process, but of course if the current process is your application instead, things go terribly astray: The Drag Manager calls a jump table entry in your application, thinking it's the Finder, and your application's routine doesn't do the same thing that the Finder routine would. Any number of spectacular effects can result.

"Now wait a minute," you're thinking, "the drag originated in one of my application's windows; how is this stuff about the Finder relevant?" The answer is in the event record you're passing to TrackDrag. An event record is supposed to contain a where field expressed in global coordinates. However, the where field your application is passing is in local coordinates. How did this happen? Well, that depends on your application, but often it can result from an application frameworks (like PowerPlant, MacApp, or THINK Class Library) modifying the event record before passing it to your code. There's no language-level way to specify that the record has been modified, so the compiler doesn't warn you. (Honestly, this is Not Your Fault.)

Your code blithely calls TrackDrag with what it assumes is a valid event record but is not. TrackDrag interprets the where field, which is actually in local coordinates, as global coordinates. This point is somewhere up and to the left of where your application expects, and quite often it's in the desktop, which as we said above is considered a Finder window for these purposes. The Drag Manager reacts by going through its ritual for drags originating in Finder windows and eventually crashes after calling some odd routine in your application, as described above.

To solve this problem, simply call LocalToGlobal on the where field of the event record before calling TrackDrag.


Q: When I drag from my application into a Finder window, the system crashes. I notice the Finder uses a windowKind value of 20 for its windows, and so does my application. When my application avoids windowKind 20, everything's hunky-dory. What's going on?

A: Through the Drag Manager, the Finder has gotten access to the windows in your application's window list (specifically, by using undocumented calls to obtain the source window of a drag). If your window's windowKind field is 20, the Finder assumes the window is one of its own (as opposed to a driver window, whose windowKind would be negative, or a dialog window, whose windowKind would be 2, and so on). The Finder grabs the value in the window's refCon field and type-casts it to a pointer to a C++ object in the Finder's heap. I think you can see where this is going: when the Finder attempts to dereference the pointer, many fascinating crashing behaviors can result.

The upshot of this Finder bug is that your application should not use windowKind values of 20.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Is there cross-platform play in slither....
So you've sunken plenty of hours into crawling around in slither.io on your iPhone or iPad. You've got your stories of tragedy and triumph, the times you coiled four snakes at one time balanced out by the others when you had a length of more than... | Read more »
Rodeo Stampede guide to running a better...
In Rodeo Stampede, honing your skills so you can jump from animal to animal and outrun the herd as long as possible is only half the fun. Once you've tamed a few animals, you can bring them home with you. [Read more] | Read more »
VoxSyn (Music)
VoxSyn 1.0 Device: iOS Universal Category: Music Price: $6.99, Version: 1.0 (iTunes) Description: VoxSyn turns your voice into the most flexible vocal sound generator ever. Instantly following even subtle modulations of pitch and... | Read more »
Catch Battleplans on Google Play from Ju...
Real-time strategy title Battleplans is due for release on Google Play on June 30th, following its release for iOS systems last month. With its simple interface and pretty graphics, the crowd-pleaser brings a formerly overlooked genre out for the... | Read more »
iDoyle: The interactive Adventures of Sh...
iDoyle: The interactive Adventures of Sherlock Holmes - A Scandal in Bohemia 1.0 Device: iOS Universal Category: Books Price: $1.99, Version: 1.0 (iTunes) Description: Special Release Price $1.99 (Normally $3.99) | Read more »
Five popular free apps to help you slim...
Thanks to retail and advertising, we're used to thinking one season ahead. Here we are just a week into the summer and we're conditioned to start thinking about the fall. [Read more] | Read more »
How to ride longer and tame more animals...
It's hard to accurately describe Rodeo Stampede to people who haven't seen it yet. It's like if someone took Crossy Roadand Disco Zoo and put them in a blender, yet with a unique game mechanic that's still simple and fun for anyone. [Read more] | Read more »
Teeny Titans - A Teen Titans Go! Figure...
Teeny Titans - A Teen Titans Go! Figure Battling Game 1.0.0 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0.0 (iTunes) Description: Teeny Titans, GO! Join Robin for a figure battling RPG of epic proportions! TEENY... | Read more »
NinjAwesome: Tips and tricks to be a mor...
Sorry about that headline, but I'm going to go ahead and assume that GameResort would not have named its game NinjAwesome without expecting some of that. It is, in fact, pretty awesome the way it combines an endless runner and old school arcade... | Read more »
Into Mirror (Games)
Into Mirror 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: "Is all that we see or seem, but a dream within a dream?"- Edgar Allan Poe New game by Lemon Jam Studio, the team behind Pursuit... | Read more »

Price Scanner via MacPrices.net

15-inch Retina MacBook Pros on sale for $200-...
B&H Photo has 15″ Retina MacBook Pros on sale for up to $210 off MSRP. Shipping is free, and B&H charges NY tax only: - 15″ 2.2GHz Retina MacBook Pro: $1799.99 $200 off MSRP - 15″ 2.5GHz... Read more
Mac minis on sale for up to $100 off MSRP
B&H Photo has Mac minis on sale for up to $100 off MSRP including free shipping plus NY sales tax only: - 1.4GHz Mac mini: $449 $50 off MSRP - 2.6GHz Mac mini: $649 $50 off MSRP - 2.8GHz Mac mini... Read more
Clearance 2015 13-inch MacBook Airs available...
B&H Photo has clearance 2015 13″ MacBook Airs available for $300 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 1.6GHz/4GB/128GB MacBook Air (MJVE2LL/A): $799.... Read more
Apple refurbished Mac minis available for up...
Apple has Certified Refurbished Mac minis available starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: - 1.4GHz Mac mini: $419 $80 off MSRP - 2.6GHz Mac... Read more
ABBYY TextGrabber: 1,000,000 Installs in 5 Da...
ABBYY, an international OCR technologies provider, has announced that their image-to-text application TextGrabber, got installed 1,000,000 times in just five days while being featured by the App... Read more
New SkinIt Waterproof Case For iPhone 6
With its impact and waterproof design, the Skinit Waterproof case provides security and protection to guarantee your phone will get you through even the most demanding outdoor conditions. The impact-... Read more
iMacs on sale for up to $150 off MSRP
B&H Photo has 21″ and 27″ iMacs on sale for up to $150 off MSRP including free shipping plus NY sales tax only: - 27″ 3.3GHz iMac 5K: $2181.11 $118 off MSRP - 27″ 3.2GHz/1TB Fusion iMac 5K: $1949... Read more
12-inch 1.1GHz Retina MacBooks on sale for $5...
B&H Photo has 2016 12″ 1.1GHz/256GB Retina MacBooks on sale for up to $50 off MSRP. Shipping is free, and B&H charges NY tax only: - 12″ 1.1GHz Space Gray Retina MacBook: $1249 $50 off MSRP... Read more
WWDC Announcements Revisited Still Underwhelm...
I was disappointed that no new MacBook hardware was announced at this year’s all-software World Wide Developer’s Conference. Not even a hint about what’s in the development pipeline. Of course, we... Read more
Twelve South Compass 2 iPad Stand Now Availab...
Twelve South has updated its most popular iPad stand, Compass 2, with the introduction of two new colors — Gold and Rose Gold. These new color options n perfectly complement the new Rose Gold iPad... Read more

Jobs Board

*Apple* iPhone 6s and New Products Tester Ne...
…we therefore look forward to put out products to quality test for durability. Apple leads the digital music revolution with its iPods and iTunes online store, Read more
Music Marketing Lead, iTunes & *Apple*...
…Music Marketing Lead is responsible for developing robust marketing campaigns and programs for Apple Music and iTunes across the whole of Apple ecosystem. This Read more
*Apple* Valley Medical Clinic is Hiring - AP...
Apple Valley Medical Clinic is Hiring! Apple Valley Medical Clinic is an independently owned practice operating a Family Medicine Clinic, a 24/7 Urgent Care, Read more
*Apple* New Products Testers Needed - Apple...
…we therefore look forward to put out products to quality test for durability. Apple leads the digital music revolution with its iPods and iTunes online store, Read more
*Apple* Solutions Consultant - APPLE (United...
Job Summary As an Apple Solutions Consultant, you'll be the link between our future customers and our products. You'll showcase your entrepreneurial spirit as you Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.