IMMPlayerPanelHandler

The IMMPlayerPanelHandler class processes the different command events for the player panel. You can override this class to provide more functionality or more precise control of the device. For example, you might call playFast instead of seekToEnd when the user presses the fast forward button for digital video. To do this, just inherit from this class and implement your own processing for fast forward.

The return value from the virtual functions specifies whether the command event is passed on for additional processing, as follows:

true
The command event requires no additional processing. Do not pass it to another handler.
false
The command event requires additional processing. Pass the command event on, as follows:
  • If there is another handler for the window, pass the command event on to the next handler.
  • If this is the last handler for the window, call IWindow::defaultProcedure to process the command event.


IMMPlayerPanelHandler - Member Functions and Data by Group

Constructors & Destructor

You can construct and destruct objects of this class.


[view class]
~IMMPlayerPanelHandler
public:
virtual ~IMMPlayerPanelHandler()

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
IMMPlayerPanelHandler
public:
IMMPlayerPanelHandler()

The Open Class Library provides only the default constructor for you to create a player panel handler object.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


Event Dispatching

Event-dispatching members evaluate an event to determine if it is appropriate for this handler object to process. If it is, this function calls the virtual function used to process the event.


[view class]
command
protected:
virtual bool command(ICommandEvent& event)

Calls the virtual functions to process a command event for a player panel.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Event Processing

Event-processing members are invoked in response to the user pressing a button on the player panel, or they are invoked by the user of this class. These can be overridden to provide more functionality or more precise control of the device. All of these methods can be thought of as button presses, even though they might have been invoked directly.


[view class]
fastForward
protected:
virtual bool fastForward(const IMMPlayerPanel& panel)

Gets called when the user presses the fast forward button. The default action is to call seekToEnd on the device. It also unlatches the play and pause buttons and disables the stop and pause buttons.

Exception

IInvalidRequest There must be a device set for the player panel.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
pause
protected:
virtual bool pause(const IMMPlayerPanel& panel)

Gets called when the user presses the pause button. The default action is to call pause on the device. If the device is already paused, it calls resume on the device and latches the play button.

Exception

IInvalidRequest There must be a device set for the player panel.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
play
protected:
virtual bool play(const IMMPlayerPanel& panel)

Gets called when the user presses the play button. The default action is to call play on the device. It also unlatches the pause button and enables the stop and pause buttons.

Exception

IInvalidRequest There must be a device set for the player panel.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
rewind
protected:
virtual bool rewind(const IMMPlayerPanel& panel)

Gets called when the user presses the rewind button. The default action is to call seekToStart on the device. It also unlatches the play and pause buttons and disables the stop and pause buttons.

Exception

IInvalidRequest There must be a device set for the player panel.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
stepBackward
protected:
virtual bool stepBackward(const IMMPlayerPanel& panel)

Gets called when the user presses the step backward button. This is only possible when step is meaningful to the device, such as for video. The default action is to call stepFrame on the device. It also unlatches the play button.

Exception

IInvalidRequest There must be a device set for the player panel.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
stepForward
protected:
virtual bool stepForward(const IMMPlayerPanel& panel)

Gets called when the user presses the step forward button. This is only possible when step is meaningful to the device, such as for video. The default action is to call stepFrame on the device. It also unlatches the play button.

Exception

IInvalidRequest There must be a device set for the player panel.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
stop
protected:
virtual bool stop(const IMMPlayerPanel& panel)

Gets called when the user presses the stop button. The default action is to call stop and seekToStart on the device. It also unlatches the play and pause buttons and disables the stop and pause buttons.

Exception

IInvalidRequest There must be a device set for the player panel.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


IMMPlayerPanelHandler - Inherited Member Functions and Data

Inherited Public Functions

ICommandHandler
IHandler

Inherited Public Data

Inherited Protected Functions

IHandler
ICommandHandler

Inherited Protected Data