Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Managing Controller Attributes

MCSetControllerBoundsRect

The MCSetControllerBoundsRect function lets you change the position and size of a movie controller. A controller's boundary rectangle encloses the control portion of the controller. In addition, in cases where the movie is attached to the controller, the boundary rectangle also encloses the movie. Note that changing the size of the boundary rectangle may result in the movie being resized as well, if the movie is attached to the controller.

pascal ComponentResult MCSetControllerBoundsRect
                                           (MovieController mc,
                                             const Rect *bounds);

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).

bounds

Points to a rectangle structure that contains the new boundary rectangle for the movie controller.

DESCRIPTION

Movie controller components can reject your request for a number of reasons. For example, some movie controller components may support only fixed-size controllers or controllers whose size is fixed in one dimension. Also, note that your application cannot change the location of an attached controller.

The movie controller component returns a value of controllerBoundsNotExact if the boundary rectangle has been changed but does not correspond to the rectangle you specified. In this case, the new boundary rectangle is always smaller than the requested rectangle.

RESULT CODES

controllerBoundsNotExact	-9996	Controller has altered the bounds you supplied
controllerHasFixedHeight	-9998	You cannot change the height of this controller
cannotMoveAttachedController	-9999	You cannot move an attached controller

SEE ALSO

To find the dimensions of the new boundary rectangle, call the MCGetControllerBoundsRect function, described in the next section.