### 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.

~IMMPlayerPanelHandler

      public:
      virtual ~IMMPlayerPanelHandler()

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

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.

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.

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

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

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

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

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

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

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

  -     virtual ~ICommandHandler()

  -     ICommandHandler()

  IHandler

  -     virtual ~IHandler()

  -     virtual IString asDebugInfo() const

  -     virtual IString asString() const

  -     virtual IHandler& disable()

  -     virtual IHandler& enable(bool enable = true)

  -     virtual IHandler& handleEventsFor(IWindow* window)

  -     IHandler()

  -     bool isEnabled() const

  -     virtual IHandler& stopHandlingEventsFor(IWindow* window)

#### Inherited Public Data

  - None

#### Inherited Protected Functions

  IHandler

  -     virtual IEventResult defaultProcedure(IEvent& event)

  -     virtual bool dispatchHandlerEvent(IEvent& event) = 0

  ICommandHandler

  -     virtual bool dispatchHandlerEvent(IEvent& event)

  -     virtual bool systemCommand(ICommandEvent& event)

#### Inherited Protected Data

  - None