ButtonClick Event (Multimedia MCI Control)

       

Occurs when the user presses and releases the mouse button over one of the buttons in the Multimedia MCI control.

Syntax

Private Sub MMControl_ButtonClick (Cancel As Integer)

Remarks

Button may be any of the following: Back, Eject, Next, Pause, Play, Prev, Record, Step, or Stop.

Each of the ButtonClick events, by default, perform an MCI command when the user chooses a button. The following table lists the MCI commands performed for each button in the control.

Button Command
Back MCI_STEP
Step MCI_STEP
Play MCI_PLAY
Pause MCI_PAUSE
Prev MCI_SEEK
Next MCI_SEEK
Stop MCI_STOP
Record MCI_RECORD
Eject MCI_SET with the MCI_SET_DOOR_OPEN parameter

Setting the Cancel parameter for the ButtonClick event to True prevents the default MCI command from being performed. The Cancel parameter can take either of the following settings.

Setting Description
True Prevents the default MCI command from being performed.
False Performs the MCI command associated with the button after performing the body of the appropriate ButtonClick event.

The body of an event procedure is performed before performing the default MCI command associated with the event. Adding code to the body of the ButtonClick events augments the functionality of the buttons. If you set the Cancel parameter to True within the body of an event procedure or pass the value True as the argument to a ButtonClick event procedure, the default MCI command associated with the event will not be performed.

Note   Issuing a Pause command to restart a paused device can end pending notifications from the original Play command if the device does not support the MCI Resume command. The Multimedia MCI control uses the MCI Play command to restart devices that do not support the MCI Resume command. Notifications from the Play command that restarts a paused device cancel callback conditions and supersede pending notifications from the original Play command.