MCGetWindowRgn(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Managing Controller Attributes

MCGetWindowRgn
The MCGetWindowRgn function allows your application to determine the window region that is actually in use by a controller and its movie. The region returned by this function contains only the visible portions of the controller and its movie.
pascal RgnHandle MCGetWindowRgn (MovieController mc, WindowPtr w);
mc
Specifies the movie controller for the operation. You obtain this identifier from the Component Manager's OpenComponent or OpenDefaultComponent function, or from the NewMovieController function (described on page 2-28).
w
Identifies the window in which the movie controller and its movie are displayed, if the control portion of the controller is attached to the movie. If the controller is detached and in a separate window from the movie, specify one of the windows.

DESCRIPTION
The returned region may consist of several discontiguous areas. For example, if a controller is detached from its movie, the window region may define separate areas for the movie and the controller. If you want to consider just the controller, you must subtract the movie from the returned region.
Your application must dispose of the returned region.
The MCGetWindowRgn function returns a handle to the window region. Your application must dispose of this region.

RESULT CODES
Memory Manager errors

SEE ALSO
You can control the clipping region that is applied to the controller by calling the MCSetClip function, which is described in the next section.