Topic: APLX Help : System Classes : Methods : Play
[ Previous | Next | Contents | Index | APL Home ]

www.microapl.co.uk

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 | APL Home ]