Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Managing Controller Attributes

MCGetControllerBoundsRgn

Some movie controllers may not be rectangular in shape. The MCGetControllerBoundsRgn function returns the actual region occupied by the controller and its movie, if the movie is attached to the controller. If the movie is not attached to its controller, the boundary region encloses only the control portion of the controller. The rectangle returned by the MCGetControllerBoundsRect function (described in the previous section) bounds the region returned by MCGetControllerBoundsRgn.

pascal RgnHandle MCGetControllerBoundsRgn (MovieController mc);

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.

DESCRIPTION

As with the MCGetControllerBoundsRect function, the MCGetControllerBoundsRgn function returns a region that reflects the size, shape, and location of the controller, even if the controller is hidden. Your application must dispose of the returned region.

The MCGetControllerBoundsRgn function returns a handle to the boundary region. Your application must dispose of this region.

RESULT CODES

Memory Manager errors

SEE ALSO

You can use the MCGetWindowRgn function, described in the next section, to determine the portion of the window that is currently in use by the controller.