Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 1 - QuickDraw GX and the Macintosh Environment / QuickDraw GX and the Macintosh Environment Reference

Macintosh Interface Functions / Associating View Devices With Macintosh Graphics Devices

GXGetViewDeviceGDevice

You can use the GXGetViewDeviceGDevice function to return the Macintosh graphics device associated with a specified view device object.

GDHandle GXGetViewDeviceGDevice(gxViewDevice theDevice);

theDevice

A reference to the view device whose graphics device is requested.

function result

A handle to the GDevice record of the specified view device.

DESCRIPTION

The GXGetViewDeviceGDevice function returns a handle to the GDevice record associated with a specified view device. The function returns nil if the view device has no GDevice record.

ERRORS, WARNINGS, AND NOTICES

Errors

out_of_memory

invalid_viewdevice_reference

SEE ALSO

Macintosh graphics devices and the GDevice record are described in Inside Macintosh: Imaging With QuickDraw.

View devices are described in the chapter "View-Related Objects" in Inside Macintosh: QuickDraw GX Objects.

To obtain the view device associated with a graphics device, use the GXGetGDeviceViewDevice function, described next.