Kanzi framework  3.9.1
Kanzi Engine API
kanzi::PopupScope Class Reference

Implements the popup scopes. More...

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

Inheritance diagram for kanzi::PopupScope:
[legend]

Public Member Functions

FocusManager::FocusScopeType getType () const override
 Returns the scope type. More...
 
 PopupScope (Node &root, FocusManager::ScopeStack &scopeStack)
 Constructor. More...
 
 ~PopupScope () override
 Destructor. More...
 
- Public Member Functions inherited from kanzi::ModalScope
void addToStack ()
 Adds the focus scope to the modal scope stack. More...
 
bool bringScopeToFront ()
 Brings a modal focus scope to the front of focus scopes. More...
 
FocusChainNode getEffectiveFocus () const
 Returns the effective focus node of a modal scope. More...
 
Node2DSharedPtr getHitTestRoot ()
 Returns the node from where the hit test iteration is started. More...
 
Node2DSharedPtr getKeyInputRoot ()
 Returns the node to which the key input is propagated. More...
 
FocusScopegetParent () const override
 Overrides FocusScope::getParent() by always returning nullptr, because modal scopes have no parent scopes. More...
 
bool isForemostScope () const
 Checks whether the focus scope is the foremost scope of the modal scope stack. More...
 
bool isNodeInScope (const Node &node) const override
 Checks whether a node is in this modal scope. More...
 
 ModalScope (Node &root, FocusManager::ScopeStack &scopeStack)
 Constructor. More...
 
void removeFromStack (FocusManager::FocusReason reason)
 Removes the focus scope from the modal scope stack. More...
 
bool sendScopeToBack (FocusManager::FocusReason reason)
 Sends a focus scope to the end of the focus scope stack with a given reason value. More...
 
FocusChainNode tryMoveFocusAcrossNestedScopes (FocusManager::FocusChainDirection direction)
 Tries to set the focus to a node relative to the focused node of the popup-type focus scope passed as an argument, using the focus chain navigation. More...
 
FocusChainNode trySetFocus (Node &node)
 Tries to set the focus to a node of the focus scope. More...
 
 ~ModalScope () override
 Destructor. More...
 
- Public Member Functions inherited from kanzi::FocusFence
 FocusFence (Node &root)
 Constructor. More...
 
- Public Member Functions inherited from kanzi::FocusScope
bool canFocusEnter () const
 Returns whether the focus can enter the focus scope. More...
 
bool canFocusLeave () const
 Returns whether the focus can leave the focus scope. More...
 
bool canGetLastFocused () const
 Returns whether the focus scope node can be the last-focused node of its owning focus scope. More...
 
FocusChainNode getFocus () const
 Returns the focus node of a focus scope. More...
 
FocusChainSharedPtr getFocusChainSnapshot ()
 Returns a snapshot of the focus chain of a focus scope. More...
 
FocusChainSharedPtr getFocusChainSnapshot (bool onlyEffectivelyVisible)
 Returns a snapshot of the focus chain of a focus scope. More...
 
FocusNavigationManipulatorSharedPtr getFocusNavigationManipulator () const
 Returns the focus navigation manipulator of a focus scope. More...
 
ModalScopegetModalScope () const
 Returns the modal scope that owns the focus scope. More...
 
NodegetRoot () const
 Returns the focus scope node. More...
 
bool isAttached () const
 Returns whether a focus scope node is attached. More...
 
bool isFocusChainEmpty () const
 Returns whether the focus chain of a focus scope is empty. More...
 
bool isFocusChainEmpty (bool onlyEffectivelyVisible) const
 Returns whether the focus chain of a focus scope is empty. More...
 
void setFocusNavigationManipulator (FocusNavigationManipulatorSharedPtr newManipulator)
 Sets the focus navigation manipulator of the focus scope. More...
 
FocusChainNode tryMoveFocusInScope (FocusManager::FocusChainDirection direction)
 Tries to set the focus to a node relative to the current focus node of the focus scope using the focus chain navigation. More...
 
FocusChainNode tryRestoreScopeFocusedNode (FocusChainNode currentFocus, FocusManager::FocusReason reason, FocusManager::FocusChainDirection direction)
 Tries to restore the focus to the last-focused node of a focus scope. More...
 
Node::VisitorResult visitFocusChain (FocusScopeVisitor &visitor)
 Visits the focus chain of the focus scope, and calls the visitor on each node. More...
 
Node::VisitorResult visitFocusScope (FocusScopeVisitor &visitor)
 Visits the focusable nodes of the focus scope, including nested focus scope nodes. More...
 
virtual ~FocusScope ()
 Destructor. More...
 
FocusChainIndex getLastFocused () const
 Returns the focus chain index of the last-focused node of a focus scope. More...
 
void setLastFocused (const FocusChainIndex &lastFocus)
 Sets the focus chain index of the last-focused node of the focus scope. More...
 
void clearLastFocused ()
 Clears the focus chain index of the last-focused node of a focus scope. More...
 
FocusChainNode getLastFocusedNode () const
 Returns the last-focused node of a focus scope. More...
 
FocusChainNode setLastFocusedNode (const Node &lastFocused)
 Sets the last-focused node of a focus scope. More...
 
void clearLastFocusedNode ()
 Set the Node::FocusedProperty value to false, and clears the last-focused node of a focus scope. More...
 

Protected Member Functions

void notifyNodeAttached (Node &node) override
 Overrides ModalScope::notifyNodeAttached(). More...
 
EventQueue::ProcessingResult processTouchPoint (const TouchPoint &point) override
 Overrides ModalScope::processTouchPoint() for popup focus scopes. More...
 
- Protected Member Functions inherited from kanzi::ModalScope
void joinScope (FocusScope &target) override
 Overrides FocusScope::joinScope();. More...
 
void notifyNodeAttached (Node &node) override
 Overrides FocusScope::notifyNodeAttached() for popups. More...
 
void notifyNodeDetached (Node &node) override
 Overrides FocusScope::notifyNodeDetached() for popups. More...
 
void notifyNodeVisibilityChanged (Node &node) override
 Overrides FocusScopeCore::notifyNodeVisibilityChanged(). More...
 
void notifyScopeInFront (ModalScope *previous, FocusManager::FocusReason reason)
 Notifies that this scope is brought to the front of the scope stack. More...
 
void notifyScopeSentToBack (ModalScope &next, FocusManager::FocusReason reason)
 Notifies that this scope is sent to the back of the scope stack. More...
 
void notifyScopeTypeChange (FocusScope &oldScopeData) override
 Overrides FocusScope::notifyScopeTypeChange();. More...
 
EventQueue::ProcessingResult processTouchPoint (const TouchPoint &point) override
 Overrides FocusScopeCore::processTouchPoint(). More...
 
void splitScope (FocusScope *source, FocusChainNode targetLastFocusNode) override
 Overrides FocusScope::splitScope();. More...
 
- Protected Member Functions inherited from kanzi::FocusFence
 FocusFence (Node &root, ScopeFlag flags)
 Constructor. More...
 
- Protected Member Functions inherited from kanzi::FocusScope
void focusNavigationHandler (FocusManager::MoveFocusMessageArguments &args)
 Navigates the focus in a scope. More...
 
 FocusScope (Node &scopeNode, ScopeFlag flags)
 Constructor. More...
 
void invalidateFocusChain () override
 Overrides FocusScopeCore::invalidateFocusChain(). More...
 
void joinScope (FocusScope &target) override
 Overrides FocusScopeCore::joinScope(). More...
 
void notifyNodeAttached (Node &node) override
 Overrides FocusScopeCore::notifyNodeAttached(). More...
 
void notifyNodeDetached (Node &node) override
 Overrides FocusScopeCore::notifyNodeDetached(). More...
 
void notifyScopeTypeChange (FocusScope &oldScopeData) override
 Overrides FocusScopeCore::notifyScopeTypeChange(). More...
 
void splitScope (FocusScope *target, FocusChainNode targetLastFocusedNode) override
 Overrides FocusScopeCore::splitScope(). More...
 
void swapScopeData (FocusScope &other)
 Swaps the focus scope data of this scope with the focus scope data of the source scope. More...
 

Additional Inherited Members

- Public Types inherited from kanzi::FocusScope
using FocusChainSharedPtr = shared_ptr< FocusChain >
 The focus chain pointer type. More...
 
- Static Public Member Functions inherited from kanzi::FocusScope
static FocusScopePtr create (FocusManager::FocusScopeType type, Node &rootNode, FocusManager::ScopeStack &scopeStack)
 Creates an instance of a focus scope type, with the rootNode as the focus scope node. More...
 
- Protected Types inherited from kanzi::FocusScope
enum  ScopeFlag {
  ScopeFlag::EnterFocusWithNavigationAllowed, ScopeFlag::LeaveFocusWithNavigationAllowed, ScopeFlag::CanGetLastFocusedNode, ScopeFlag::DisableAll,
  ScopeFlag::EnableAll
}
 Defines the scope flags. More...
 
- Protected Attributes inherited from kanzi::ModalScope
Node::MessageSubscriptionToken m_bringScopeToFrontMessageToken
 Message subscription token for FocusManager::BringScopeToFrontMessage. More...
 
Node2DWeakPtr m_rootForKey
 The root node until which the key messages are bubbled. More...
 
Node2DWeakPtr m_rootForTouch
 The root node where the touch hit testing is started for the modal scope. More...
 
FocusManager::ScopeStackm_scopeStack
 The focus scope stack. More...
 
Node::MessageSubscriptionToken m_sendScopeToBackMessageToken
 Message subscription token for FocusManager::SendScopeToBaskMessage. More...
 
- Protected Attributes inherited from kanzi::FocusScope
const ScopeFlag m_scopeFlags
 The scope flags. More...
 

Detailed Description

Implements the popup scopes.

Since
Kanzi 3.7.0

Constructor & Destructor Documentation

◆ PopupScope()

kanzi::PopupScope::PopupScope ( Node root,
FocusManager::ScopeStack scopeStack 
)
explicit

Constructor.

◆ ~PopupScope()

kanzi::PopupScope::~PopupScope ( )
override

Destructor.

Member Function Documentation

◆ getType()

FocusManager::FocusScopeType kanzi::PopupScope::getType ( ) const
overridevirtual

Returns the scope type.

Returns
Returns FocusManager::FocusScopeType::Popup.

Reimplemented from kanzi::ModalScope.

◆ notifyNodeAttached()

void kanzi::PopupScope::notifyNodeAttached ( Node node)
overrideprotected

◆ processTouchPoint()

EventQueue::ProcessingResult kanzi::PopupScope::processTouchPoint ( const TouchPoint point)
overrideprotected

Overrides ModalScope::processTouchPoint() for popup focus scopes.


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