< Previous PageNext Page > Hide TOC

Deprecated Application Manager Functions

A function identified as deprecated has been superseded and may become unsupported in the future.

Deprecated in Mac OS X v10.5

BeginQDContextForApplicationDockTile

Returns a QuickDraw graphics port for drawing in the application Dock tile. (Deprecated in Mac OS X v10.5. Use BeginCGContextForApplicationDockTile or HIApplicationCreateDockTileContext instead.)

CGrafPtr BeginQDContextForApplicationDockTile (
   void
);

Return Value

A pointer to a graphics port. You can use this port to draw into your application Dock tile with QuickDraw.

Discussion

This function locks the application Dock tile to prevent the Dock from drawing in the tile. When you are finished using the graphics port, you must call the function EndQDContextForApplicationDockTile to release the port and the lock. Do not use DisposePort for this purpose.

Availability
See Also
Declared In
MacApplication.h

EndQDContextForApplicationDockTile

Releases the QuickDraw graphics port for an application Dock tile. (Deprecated in Mac OS X v10.5. Use EndCGContextForApplicationDockTile instead.)

void EndQDContextForApplicationDockTile (
   CGrafPtr inContext
);

Parameters
inContext

A QuickDraw graphics port acquired by calling BeginQDContextForApplicationDockTile. On output, the port is invalid and should no longer be used.

Discussion

This function also releases the lock on the application Dock tile, signaling the Dock that you are done drawing in the tile.

Availability
See Also
Declared In
MacApplication.h

< Previous PageNext Page > Hide TOC


© 2001, 2007 Apple Inc. All Rights Reserved. (Last updated: 2007-10-31)


Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.