QMedia Movie area commands |

### QM_SetAreaMovie

QM_SetAreaMovie(areaRef; movieRef):error
| areaRef | Longint | Movie area reference
| movieRef | Longint | Movie reference
| error | Longint | Error result

Assigns a movie instance to a movie plug-in area. QMedia creates a movie controller for the assigned movie.

The movie plug-in area is specified by the areaRef parameter.

Parameter movieRef is a reference to a movie instance. A movie instance is created with a call to QM_NewMovieFromFile or QM_NewMovieFromURL. Any movie instance previously assigned to the area is freed. If movieRef is 0, the area is cleared.

If the command completes successfully, the result is set to zero (qm_noErr), otherwise an non-zero error code is returned.

Example

``Assign movie $movie to plug-in area xMovieArea` `` `$error:=QM_SetAreaMovie (xMovieArea;$movie)` ``

Related commands

QM_GetAreaMovie | Returns the movie currently assigned to a movie plug-in area.

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