Important: The information in this document is obsolete and should not be used for new development.
GetPortTo save the current graphics port (basic or color), you can use the
PROCEDURE GetPort (VAR port: GrafPtr);
- A pointer to a
GrafPortrecord. If the current graphics port is a color graphics port,
CGrafPortrecord into a
GetPortprocedure returns a pointer to the current graphics port in the
portparameter. The current graphics port is also available through the global variable
thePort, but you may prefer to use
GetPortfor better readability of your code. For example, your program could include
GetPort(savePort)before setting a new graphics port, followed by
SetPort(savePort)to restore the previous port.
SEE ALSOListing 2-3 on page 2-16 illustrates how to use
GetPortto save the graphics port for the active window and
SetPortto make an inactive window the current graphics port; then how to use
SetPortagain to restore the active window as the current graphics port. The basic graphics port is described on page 2-27. The
SetPortprocedure is described next.
When your application runs in Color QuickDraw or uses offscreen graphics worlds, it should use the
GetGWorldprocedure instead of
GetGWorldprocedure saves the current graphics port for basic and color graphics ports as well as offscreen graphics worlds. See the chapter "Offscreen Graphics Worlds" for more information.