Rogue Wave Views
Manager Package API Reference Guide
Product Documentation:

Rogue Wave Views
Documentation Home
List of all members | Public Member Functions | Friends
IlvManagerEventHook Class Referenceabstract

Manager hook class. More...

#include <ilviews/manager/event.h>

Public Member Functions

 IlvManagerEventHook ()
 Constructor. More...
 
virtual ~IlvManagerEventHook ()
 Destructor. More...
 
IlvManagergetManager () const
 Returns the manager. More...
 
virtual IlBoolean handleEvent (IlvEvent &event, IlvView *view)=0
 Processes an event. More...
 
virtual void setManager (IlvManager *manager)
 Sets the manager. More...
 

Friends

class IlvManager
 

Detailed Description

Manager hook class.

Library: ilvmgr

This class is used to monitor events that occur within views associated with a manager. Instances of this class are called event hooks. They are used to notify the user of any event that occurs within a manager view, before the event is sent to view interactors, object interactors, or accelerators.

Event hooks are installed on managers using IlvManager::installEventHook and removed using IlvManager::removeEventHook.

Deleting a manager will delete the event hooks installed on it.

See also
IlvManager.

Constructor & Destructor Documentation

§ IlvManagerEventHook()

IlvManagerEventHook::IlvManagerEventHook ( )

Constructor.

Initializes a new event hook, ready to be installed on any manager.

§ ~IlvManagerEventHook()

virtual IlvManagerEventHook::~IlvManagerEventHook ( )
virtual

Destructor.

Releases the memory used by the instance.

Member Function Documentation

§ getManager()

IlvManager* IlvManagerEventHook::getManager ( ) const

Returns the manager.

Returns
The manager to which the hook is connected.

§ handleEvent()

virtual IlBoolean IlvManagerEventHook::handleEvent ( IlvEvent event,
IlvView view 
)
pure virtual

Processes an event.

Called by the manager where this hook is installed when an event occurs in a view connected to this manager.

Returns
IlTrue when the event is considered completely consumed; no other event hook will be considered, and the manager will not trigger any interactor or accelerator. Otherwise, the method returns IlFalse; the other event hooks will be called and further event management will be performed by the manager.
Parameters
eventThe event.
viewThe manager view in which the event occurred.

§ setManager()

virtual void IlvManagerEventHook::setManager ( IlvManager manager)
virtual

Sets the manager.

Connects the hook to a manager. This is equivalent to calling IlvManager::removeEventHook on the manager where this hook was installed, followed by IlvManager::installEventHook on manager.

Parameters
managerThe manager to connect the hook to.

© Copyright 2017, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.