Using MultiMedia Controls

The steps that you perform to use the MultiMedia control are:

  1. Add a MultiMedia control to your form, and then set the required properties.

  2. Set the mediaName property, by performing one of the following actions.

    • Specify the file or device in the Specific sheet of the Properties dialog in Painter.

    • Call the openDialog method to enable the user to select the file or device to be loaded.

    • Explicitly assign a value to the property in your logic.

  3. Reimplement event methods.

  4. Use the MultiMedia methods to control the behavior of the file or device, or use the sendString method to control the file or device in a more complex fashion.

When the playbar is visible on the control, no JADE events are issued for mouse actions over that playbar area. In addition, if the playbar is visible and the useDotNetVersion property is set to true, it is drawn using WPF entities and it has a different appearance from the playbar drawn using an MP3 file type.

Setting the zoom property to zero (0) when the value of the autoSize property is false stretches the media image to the current size of the client area of the control.

The MultiMedia control is not supported on forms defined as Web pages and is ignored when HTML is generated.

To play a video file, you need only perform the following actions.

  1. Set the mediaName property to the file name that is to be played

  2. Call the play method, as shown in the code fragment in the following example.

    mmcontrol.mediaName := "c:\image.avi";
mmcontrol.play;

If the useDotNetVersion property is set to true, media attribute values position (obtained by calling the getEndPosition or getStartPosition method) and length (obtained by calling the getLength method) are not available until the medium has been opened and the notifyMedia or notifyMode event has been received. For details about using the MP4 version of a control, see the useDotNetVersion property.