Kanzi Framework  3.9.0
Kanzi Engine API
kanzi::InputManipulator::Collection Struct Reference

Common functions of collections of attached InputManipulators processing a specific input event type. More...

#include <kanzi/core.ui/input/input_manipulator.hpp>

Public Types

using NotifierFunc = function< ProcessingResult(InputManipulator &)>
 Notifier functor type. More...
 
enum  ProcessingResult { ProcessingResult::Continue, ProcessingResult::StopRouting, ProcessingResult::Abort }
 Input processing result. More...
 

Public Member Functions

void add (InputManipulator *inputManipulator)
 Adds a manipulator to the collection. More...
 
void cancelAllActiveManipulators ()
 Cancels all manipulators in the collection. More...
 
void cancelAllManipulatorsInSubtree (const Node &root)
 Cancels all active cancelable manipulators for the root node and its descendant nodes in the same popup-type scope. More...
 
void cancelIncompatibleManipulators (InputManipulator *inputManipulator)
 Cancels all manipulators in the collection, except the one that you pass to the function. More...
 
void clearStatus ()
 Clears handled status of all attached input manipulators. More...
 
 Collection (InputManager &inputManager)
 Collection constructor. More...
 
void compact ()
 Erases all null-manipulator elements from the collection. More...
 
InputManagergetInputManager () const
 Returns the input manager that owns the collection. More...
 
bool hasInvalid () const
 Checks whether there are invalid attached manipulators. More...
 
bool isAllowed (InputManipulator *inputManipulator)
 Checks whether the manipulator that you pass to the function is allowed. More...
 
bool isEmpty () const
 Returns whether the collection is empty. More...
 
bool isLocked () const
 Returns whether the collection is locked agains changes not performed during event processing. More...
 
void lock ()
 Locks the collection to guard it from external changes. More...
 
EventQueue::ProcessingResult processEvent (InputEvent &event, ModalScope &modalScope)
 Processes an input event. More...
 
void purgeTouchPoints ()
 Removes from the touch point cache all touch points that are in the "up" state. More...
 
void remove (InputManipulator *inputManipulator)
 Removes a manipulator from the collection. More...
 
void removeAllManipulators ()
 Removes all manipulators from the collection. More...
 
void removeCanceledManipulators ()
 Removes the canceled manipulators from the collection. More...
 
void removeIncompatibleManipulators (InputManipulator *inputManipulator)
 Removes all manipulators from the collection, except the one that you pass to the function. More...
 
void unlock ()
 Unlocks a previously locked collection. More...
 
ProcessingResult updateManipulator (InputManipulator *inputManipulator, const NotifierFunc &notifier)
 Updates the inputManipulator calling the notifier function on it. More...
 

Detailed Description

Common functions of collections of attached InputManipulators processing a specific input event type.

Since
Kanzi 3.9.0 moved from InputManager to InputManipulator.

Member Typedef Documentation

◆ NotifierFunc

Member Enumeration Documentation

◆ ProcessingResult

Input processing result.

The result is returned by the notifier functions and drives the input propagation in the hit test, or the focus node tree.

Enumerator
Continue 

Continue input processing.

StopRouting 

Stop routing the input to nodes in the node tree, but continue notifying the input manipulators in the current node.

Abort 

Abort input processing.

Constructor & Destructor Documentation

◆ Collection()

kanzi::InputManipulator::Collection::Collection ( InputManager inputManager)
inlineexplicit

Collection constructor.

Member Function Documentation

◆ getInputManager()

InputManager* kanzi::InputManipulator::Collection::getInputManager ( ) const
inline

Returns the input manager that owns the collection.

Returns
The input manager that owns the collection.

◆ isEmpty()

bool kanzi::InputManipulator::Collection::isEmpty ( ) const
inline

Returns whether the collection is empty.

Returns
If the collection is empty, true, otherwise false.

◆ add()

void kanzi::InputManipulator::Collection::add ( InputManipulator inputManipulator)

Adds a manipulator to the collection.

Parameters
inputManipulatorThe manipulator that you want to add to the collection.

◆ remove()

void kanzi::InputManipulator::Collection::remove ( InputManipulator inputManipulator)

Removes a manipulator from the collection.

Parameters
inputManipulatorThe manipulator that you want to remove from the collection.

◆ removeIncompatibleManipulators()

void kanzi::InputManipulator::Collection::removeIncompatibleManipulators ( InputManipulator inputManipulator)

Removes all manipulators from the collection, except the one that you pass to the function.

Parameters
inputManipulatorThe manipulator that you want to keep in the collection.

◆ removeCanceledManipulators()

void kanzi::InputManipulator::Collection::removeCanceledManipulators ( )

Removes the canceled manipulators from the collection.

◆ removeAllManipulators()

void kanzi::InputManipulator::Collection::removeAllManipulators ( )

Removes all manipulators from the collection.

◆ cancelIncompatibleManipulators()

void kanzi::InputManipulator::Collection::cancelIncompatibleManipulators ( InputManipulator inputManipulator)

Cancels all manipulators in the collection, except the one that you pass to the function.

Parameters
inputManipulatorThe manipulator that you do not want to cancel.

◆ cancelAllActiveManipulators()

void kanzi::InputManipulator::Collection::cancelAllActiveManipulators ( )

Cancels all manipulators in the collection.

◆ cancelAllManipulatorsInSubtree()

void kanzi::InputManipulator::Collection::cancelAllManipulatorsInSubtree ( const Node root)

Cancels all active cancelable manipulators for the root node and its descendant nodes in the same popup-type scope.

Parameters
rootThe root node of the subtree in which to cancel the manipulators.
Since
Kanzi 3.9.0

◆ compact()

void kanzi::InputManipulator::Collection::compact ( )

Erases all null-manipulator elements from the collection.

◆ hasInvalid()

bool kanzi::InputManipulator::Collection::hasInvalid ( ) const

Checks whether there are invalid attached manipulators.

Returns
If the collection contains invalid attached manipulators, true, otherwise false.

◆ clearStatus()

void kanzi::InputManipulator::Collection::clearStatus ( )

Clears handled status of all attached input manipulators.

◆ isAllowed()

bool kanzi::InputManipulator::Collection::isAllowed ( InputManipulator inputManipulator)

Checks whether the manipulator that you pass to the function is allowed.

Parameters
inputManipulatorThe manipulator for which you want to check whether it is allowed.

◆ updateManipulator()

ProcessingResult kanzi::InputManipulator::Collection::updateManipulator ( InputManipulator inputManipulator,
const NotifierFunc notifier 
)

Updates the inputManipulator calling the notifier function on it.

◆ purgeTouchPoints()

void kanzi::InputManipulator::Collection::purgeTouchPoints ( )

Removes from the touch point cache all touch points that are in the "up" state.

◆ processEvent()

EventQueue::ProcessingResult kanzi::InputManipulator::Collection::processEvent ( InputEvent event,
ModalScope modalScope 
)

Processes an input event.

Parameters
eventThe input event to process. This is either a touch, a pointer or a key event.
modalScopeThe foremost modal or popup focus scope.
Returns
The event queue processing result value.

◆ lock()

void kanzi::InputManipulator::Collection::lock ( )

Locks the collection to guard it from external changes.

◆ unlock()

void kanzi::InputManipulator::Collection::unlock ( )

Unlocks a previously locked collection.

◆ isLocked()

bool kanzi::InputManipulator::Collection::isLocked ( ) const
inline

Returns whether the collection is locked agains changes not performed during event processing.

Returns
If the collection is processing an event, returns true, otherwise returns false.

The documentation for this struct was generated from the following file: