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

GXGetGDeviceViewDevice

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

gxViewDevice GXGetGDeviceViewDevice(GDHandle qdGDevice);

qdGDevice

A handle to the GDevice record of the graphics device whose view device is requested.

function result

A reference to the view device object associated with the specified graphics device.

DESCRIPTION

The GXGetGDeviceViewDevice function returns a reference to the view device object associated with a specified graphics device. The function returns nil if the graphics device has no view device.

ERRORS, WARNINGS, AND NOTICES

Errors

out_of_memory

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 graphics device associated with a view device, use the GXGetViewDeviceGDevice function, described in the previous section.