QMedia Movie area geometry commands |

### QM_SetControllerRect

QM_SetControllerRect(areaRef; controllerLeft; controllerTop; controllerRight; controllerBottom):error
| areaRef | Longint | Movie area reference
| controllerLeft | Longint | Controller left
| controllerTop | Longint | Controller top
| controllerRight | Longint | Controller right
| controllerBottom | Longint | Controller bottom
| error | Longint | Error result

Changes the position and size of the movie controler in a movie plug-in area. The coordinates of the controller's boundary rectangle are specified relative to the top-left corner of the plug-in area.

The movie plug-in area is specified by areaRef.

Parameters controllerLeft, controllerTop, controllerRight and controllerBottom are the coordinates of the movie controller's left, top, right and bottom edges respectively. All coordinates must be specified relative to the top-left corner of the plug-in area.

When calling this command, QuickTime may adjust the actual location and size of the movie controller. For example, if the specified rectangle is taller than the movie controller, QuickTime centers the movie controller in the rectangle (the movie controller has a fixed height). In that case, parameters controllerLeft, controllerTop, controllerRight and controllerBottom also receive the actual coordinates of the controller's bounding rectangle.

Example

``Attach the movie controller to the top edge of plug-in area xMovieArea` `` `C_LONGINT($areaLeft;$areaTop;$areaRight;$areaBottom)` `` `$error:=QM_GetAreaRect (xMovieArea;$areaLeft;$areaTop;$areaRight;$areaBottom)` `` `C_LONGINT($controllerLeft;$controllerTop;$controllerRight;$controllerBottom)` `` `$controllerLeft:=$areaLeft` `$controllerTop:=$areaTop` `$controllerRight:=$areaRight` `$controllerBottom:=$areaTop+16` `` `$error:=QM_SetControllerRect (xMovieArea;$controllerLeft;$controllerTop;$controllerRight;$controllerBottom)` `` ``

Related commands

QM_GetControllerRect | Returns the boundary rectangle of the movie controler in a movie plug-in area.
QM_SetMovieRect | Changes the position and size of the movie in a movie plug-in area.
QM_GetMovieRect | Returns the boundary rectangle of the movie in a movie plug-in area.

QMedia © Escape OE
Generated by QDoc 2.8 on Thu, Nov 24, 2011 18:40:17