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...
InputManager *	getInputManager () 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

using kanzi::InputManipulator::Collection::NotifierFunc = function<ProcessingResult(InputManipulator&)>

Notifier functor type.

Member Enumeration Documentation

ProcessingResult

enum kanzi::InputManipulator::Collection::ProcessingResult

strong

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

inputManipulator

The manipulator that you want to add to the collection.

remove()

void kanzi::InputManipulator::Collection::remove

(

InputManipulator *

inputManipulator

)

Removes a manipulator from the collection.

Parameters

inputManipulator

The 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

inputManipulator

The 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

inputManipulator

The 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

root	The 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

inputManipulator

The 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

event	The input event to process. This is either a touch, a pointer or a key event.
modalScope	The 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:

• kanzi/core.ui/input/input_manipulator.hpp