Provides the functionality of handling keyboard navigation and maintaining the two dimensional keyboard focus chain. More...

Inheritance diagram for Dali::Toolkit::KeyboardFocusManager:

Public Types
typedef Signal< Actor(Actor, Actor, Control::KeyboardFocus::Direction) >	PreFocusChangeSignalType
	Pre focus change signal.
typedef Signal< void(Actor, Actor) >	FocusChangedSignalType
	Focus changed signal.
typedef Signal< void(Actor, bool) >	FocusGroupChangedSignalType
	Focus group changed signal.
typedef Signal< void(Actor) >	FocusedActorEnterKeySignalType
	Focused actor has the enter key pressed signal.
Public Member Functions
	KeyboardFocusManager ()
	Creates a KeyboardFocusManager handle; this can be initialized with KeyboardFocusManager::New().
	~KeyboardFocusManager ()
	Destructor.
bool	SetCurrentFocusActor (Actor actor)
	Moves the keyboard focus to the given actor.
Actor	GetCurrentFocusActor ()
	Gets the current focused actor.
bool	MoveFocus (Control::KeyboardFocus::Direction direction)
	Moves the focus to the next focusable actor in the focus chain in the given direction (according to the focus traversal order).
void	ClearFocus ()
	Clears the focus from the current focused actor if any, so that no actor is focused in the focus chain.
void	SetFocusGroupLoop (bool enabled)
	Sets whether the focus movement should be looped within the same focus group.
bool	GetFocusGroupLoop () const
	Gets whether the focus movement should be looped within the same focus group.
void	SetAsFocusGroup (Actor actor, bool isFocusGroup)
	Sets whether an actor is a focus group that can limit the scope of focus movement to its child actors in the focus chain.
bool	IsFocusGroup (Actor actor) const
	Checks whether the actor is set as a focus group or not.
Actor	GetFocusGroup (Actor actor)
	Returns the closest ancestor of the given actor that is a focus group.
void	SetFocusIndicatorActor (Actor indicator)
	Sets the focus indicator actor.
Actor	GetFocusIndicatorActor ()
	Gets the focus indicator actor.
void	MoveFocusBackward ()
	Move the focus to prev focused actor.
PreFocusChangeSignalType &	PreFocusChangeSignal ()
	This signal is emitted before the focus is going to be changed.
FocusChangedSignalType &	FocusChangedSignal ()
	This signal is emitted after the current focused actor has been changed.
FocusGroupChangedSignalType &	FocusGroupChangedSignal ()
	This signal is emitted when the focus group has been changed.
FocusedActorEnterKeySignalType &	FocusedActorEnterKeySignal ()
	This signal is emitted when the current focused actor has the enter key pressed on it.
Static Public Member Functions
static KeyboardFocusManager	Get ()
	Gets the singleton of KeyboardFocusManager object.

Detailed Description

Provides the functionality of handling keyboard navigation and maintaining the two dimensional keyboard focus chain.

It provides functionality of setting the focus and moving the focus in four directions (i.e. Left, Right, Up and Down). It also draws a highlight for the focused actor and emits a signal when the focus is changed.

Signals | Signal Name | Method | |------------------------------|------------------------------------| | keyboardPreFocusChange | PreFocusChangeSignal() | | keyboardFocusChanged | FocusChangedSignal() | | keyboardFocusGroupChanged | FocusGroupChangedSignal() | | keyboardFocusedActorEnterKey | FocusedActorEnterKeySignal() |

Since:: 2.4, DALi version 1.0.0

Constructor & Destructor Documentation

Dali::Toolkit::KeyboardFocusManager::KeyboardFocusManager ( )

Creates a KeyboardFocusManager handle; this can be initialized with KeyboardFocusManager::New().

Calling member functions with an uninitialized handle is not allowed.

Since:: 2.4, DALi version 1.0.0

Dali::Toolkit::KeyboardFocusManager::~KeyboardFocusManager ( )

Destructor.

This is non-virtual since derived Handle types must not contain data or virtual methods.

Since:: 2.4, DALi version 1.0.0

Member Function Documentation

void Dali::Toolkit::KeyboardFocusManager::ClearFocus ( )

Clears the focus from the current focused actor if any, so that no actor is focused in the focus chain.

It will emit focus changed signal without current focused actor.

Since:: 2.4, DALi version 1.0.0

Precondition:: The KeyboardFocusManager has been initialized.

FocusChangedSignalType& Dali::Toolkit::KeyboardFocusManager::FocusChangedSignal ( )

This signal is emitted after the current focused actor has been changed.

A callback of the following type may be connected:

   void YourCallbackName(Actor originalFocusedActor, Actor currentFocusedActor);

Since:: 2.4, DALi version 1.0.0

Returns:: The signal to connect to

Precondition:: The Object has been initialized.

FocusedActorEnterKeySignalType& Dali::Toolkit::KeyboardFocusManager::FocusedActorEnterKeySignal ( )

This signal is emitted when the current focused actor has the enter key pressed on it.

A callback of the following type may be connected:

   void YourCallbackName(Actor enterPressedActor);

Since:: 2.4, DALi version 1.0.0

Returns:: The signal to connect to

Precondition:: The Object has been initialized.

FocusGroupChangedSignalType& Dali::Toolkit::KeyboardFocusManager::FocusGroupChangedSignal ( )

This signal is emitted when the focus group has been changed.

If the current focus group has a parent layout control, KeyboardFocusManager will make the best guess for the next focus group to move the focus to in the given direction (forward or backward). If not, the application has to set the new focus.

A callback of the following type may be connected:

   void YourCallbackName(Actor currentFocusedActor, bool forward);

Since:: 2.4, DALi version 1.0.0

Returns:: The signal to connect to

Precondition:: The Object has been initialized.

static KeyboardFocusManager Dali::Toolkit::KeyboardFocusManager::Get ( ) [static]

Gets the singleton of KeyboardFocusManager object.

Since:: 2.4, DALi version 1.0.0

Returns:: A handle to the KeyboardFocusManager control

Actor Dali::Toolkit::KeyboardFocusManager::GetCurrentFocusActor ( )

Gets the current focused actor.

Since:: 2.4, DALi version 1.0.0

Returns:: A handle to the current focused actor or an empty handle if no actor is focused

Precondition:: The KeyboardFocusManager has been initialized.

Actor Dali::Toolkit::KeyboardFocusManager::GetFocusGroup ( Actor actor )

Returns the closest ancestor of the given actor that is a focus group.

Since:: 2.4, DALi version 1.0.0

Parameters:

actor The actor to be checked for its focus group

Returns:: The focus group the given actor belongs to or an empty handle if the given actor doesn't belong to any focus group

bool Dali::Toolkit::KeyboardFocusManager::GetFocusGroupLoop ( ) const

Gets whether the focus movement should be looped within the same focus group.

Since:: 2.4, DALi version 1.0.0

Returns:: Whether the focus movement should be looped

Precondition:: The KeyboardFocusManager has been initialized.

Actor Dali::Toolkit::KeyboardFocusManager::GetFocusIndicatorActor ( )

Gets the focus indicator actor.

Since:: 2.4, DALi version 1.0.0

Returns:: A handle to the focus indicator actor

Precondition:: The KeyboardFocusManager has been initialized.

bool Dali::Toolkit::KeyboardFocusManager::IsFocusGroup ( Actor actor ) const

Checks whether the actor is set as a focus group or not.

Since:: 2.4, DALi version 1.0.0

Parameters:

actor The actor to be checked

Returns:: Whether the actor is set as a focus group

Precondition:: The KeyboardFocusManager has been initialized.; The Actor has been initialized.

bool Dali::Toolkit::KeyboardFocusManager::MoveFocus ( Control::KeyboardFocus::Direction direction )

Moves the focus to the next focusable actor in the focus chain in the given direction (according to the focus traversal order).

Since:: 2.4, DALi version 1.0.0

Parameters:

direction The direction of focus movement

Returns:: true if the movement was successful

Precondition:: The KeyboardFocusManager has been initialized.

void Dali::Toolkit::KeyboardFocusManager::MoveFocusBackward ( )

Move the focus to prev focused actor.

Since:: 4.0, DALi version 1.2.19

PreFocusChangeSignalType& Dali::Toolkit::KeyboardFocusManager::PreFocusChangeSignal ( )

This signal is emitted before the focus is going to be changed.

KeyboardFocusManager makes the best guess for which actor to focus towards the given direction, but applications might want to change that. By connecting with this signal, they can check the proposed actor to focus and return a different actor if they wish. This signal is only emitted when the navigation key is pressed and KeyboardFocusManager tries to move the focus automatically. It won't be emitted for focus movement by calling SetCurrentFocusActor directly.

A callback of the following type may be connected:

   Actor YourCallbackName(Actor currentFocusedActor, Actor proposedActorToFocus, Control::KeyboardFocus::Direction direction);

Since:: 2.4, DALi version 1.0.0

Returns:: The signal to connect to

Precondition:: The Object has been initialized.

void Dali::Toolkit::KeyboardFocusManager::SetAsFocusGroup	(	Actor	actor,
		bool	isFocusGroup
	)

Sets whether an actor is a focus group that can limit the scope of focus movement to its child actors in the focus chain.

Layout controls set themselves as focus groups by default.

Since:: 2.4, DALi version 1.0.0

Parameters:

actor	The actor to be set as a focus group
isFocusGroup	Whether to set the actor as a focus group or not

Precondition:: The KeyboardFocusManager has been initialized.; The Actor has been initialized.

bool Dali::Toolkit::KeyboardFocusManager::SetCurrentFocusActor ( Actor actor )

Moves the keyboard focus to the given actor.

Only one actor can be focused at the same time. The actor must be in the stage already and keyboard focusable.

Since:: 2.4, DALi version 1.0.0

Parameters:

actor The actor to be focused

Returns:: Whether the focus is successful or not

Precondition:: The KeyboardFocusManager has been initialized.; The Actor has been initialized.

void Dali::Toolkit::KeyboardFocusManager::SetFocusGroupLoop ( bool enabled )

Sets whether the focus movement should be looped within the same focus group.

The focus movement is not looped by default.

Since:: 2.4, DALi version 1.0.0

Parameters:

enabled Whether the focus movement should be looped

Precondition:: The KeyboardFocusManager has been initialized.

void Dali::Toolkit::KeyboardFocusManager::SetFocusIndicatorActor ( Actor indicator )

Sets the focus indicator actor.

This will replace the default focus indicator actor in KeyboardFocusManager and will be added to the focused actor as a highlight.

Since:: 2.4, DALi version 1.0.0

Parameters:

indicator The indicator actor to be added

Precondition:: The KeyboardFocusManager has been initialized.; The indicator actor has been initialized.

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation