Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 2 - QuickDraw GX Memory Management / QuickDraw GX Memory Management Reference

Functions / Working With Multiple Graphics Clients

GXSetGraphicsClient

You can use the GXSetGraphicsClient function to change the active graphics client for your application.

void GXSetGraphicsClient(gxGraphicsClient client);

client

A reference to the graphics client that is to become active.

DESCRIPTION

The GXSetGraphicsClient function can be used to switch to any of the graphics clients that your application owns; it may not switch to graphics clients that other applications own.

The active graphics client determines which QuickDraw GX graphics client heap to use for subsequent QuickDraw GX calls. Note that if you create a QuickDraw GX object with one graphics client active and switch to another one, you may not make calls that use the object. This is because an object cannot be shared by graphics clients. The object must be duplicated.

SEE ALSO

See the section"Working With Multiple Graphics Clients" beginning on page 2-16 for more information about multiple graphics clients.