Deprecated Application Manager Functions

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

Deprecated in OS X v10.5

BeginQDContextForApplicationDockTile

Returns a QuickDraw graphics port for drawing in the application Dock tile. (Deprecated in 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
  • Available in OS X v10.0 and later.
  • Deprecated in OS X v10.5.
  • Not available to 64-bit applications.
Declared In
MacApplication.h

EndQDContextForApplicationDockTile

Releases the QuickDraw graphics port for an application Dock tile. (Deprecated in 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
  • Available in OS X v10.0 and later.
  • Deprecated in OS X v10.5.
  • Not available to 64-bit applications.
Declared In
MacApplication.h