QMedia

Movie area event commands

QMedia lets you intercept and handle a number of events which are produced by QuickTime while a movie is hosted in a movie plug-in area.

These events can be produced as a result of user interaction, like mouse clicks on the movie area, or of specific movie activity, like the movie being started or stopped. In order to intercept and to handle these events, QMedia lets you declare a handler method that is able of capturing these events before they are serviced by QuickTime's internal handling mechanism.

All events provided by QMedia are by default handled by QuickTime. QuickTime handles all events regardless of whether there is a handler method or not. The purpose of existence of a handler method can be, for example:

• To render your application aware of one or more event types;
• To let you handle events in your own special way;
• To let you decide whether to forward an event to QuickTime or not.

There are several types of events, each with several properties specific to its type. As the handler method is called for each event, the specific event properties are each time passed to the handler method as a set of process variables.

The event handler method works much like a typical form method in 4D: it contains a large case statement where each event type is individually intercepted and handled.

Structure of the Event Handler Method

An event handler method must comply with the following calling interface:

If eventHandled ($0) returns 1, processing of the event stops at this point. If it returns any value other than 1, the event is passed on to QuickTime for further processing.

The handler will intercept all event types defined using the QM_SetEventHandler command.

The types of events currently supported are:

Example event handler