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