## The `Play' method

Argument: None
Result: Integer scalar - see text

Valid for: Movie

The `Play` method starts the current movie from the current position. If the movie is already playing, it has no effect. If the movie has ended, the current position will be at the end of the movie, so the `Play` method will have no visible effect unless the `Rewind` method is first called.

You typically use the `Play` method for a Movie object which does not have a controller (i.e. the `style` property is 1 or 2), in three main circumstances:

- For a movie which has been newly opened, to begin the movie;
- For a movie which has been paused using the `Stop` method, to resume playing from the current position;
- For a movie which has ended and which you want to repeat, you invoke the `Rewind` method and then the `Play` method.

The `Play` method returns a result which is a code as follows:

        ¯1    Movie file not yet specified (or user chose Cancel in the movie
              selection dialog, or an error occurred in opening the file)
         1    Movie playing
         2    Movie not playing because it has ended

Topic: APLX Help : System Classes : Methods : Play

[ Previous | Next | Contents | Index ]