This is the internal base class for all controls. More...

Inheritance diagram for Dali::Toolkit::Internal::Control:

Public Member Functions
virtual	~Control ()
	Virtual destructor.
void	SetStyleName (const std::string &styleName)
const std::string &	GetStyleName () const
void	SetBackgroundColor (const Vector4 &color)
Vector4	GetBackgroundColor () const
void	SetBackgroundImage (Image image)
void	ClearBackground ()
void	EnableGestureDetection (Gesture::Type type)
	Allows deriving classes to enable any of the gesture detectors that are available.
void	DisableGestureDetection (Gesture::Type type)
	Allows deriving classes to disable any of the gesture detectors.
PinchGestureDetector	GetPinchGestureDetector () const
	If deriving classes wish to fine tune pinch gesture detection then they can access the gesture detector through this API and modify the detection.
PanGestureDetector	GetPanGestureDetector () const
	If deriving classes wish to fine tune pan gesture detection then they can access the gesture detector through this API and modify the detection.
TapGestureDetector	GetTapGestureDetector () const
	If deriving classes wish to fine tune tap gesture detection then they can access the gesture detector through this API and modify the detection.
LongPressGestureDetector	GetLongPressGestureDetector () const
	If deriving classes wish to fine tune long press gesture detection then they can access the gesture detector through this API and modify the detection.
void	SetKeyboardNavigationSupport (bool isSupported)
	Sets whether this control supports two dimensional keyboard navigation (i.e. whether it knows how to handle the keyboard focus movement between its child actors).
bool	IsKeyboardNavigationSupported ()
	Gets whether this control supports two dimensional keyboard navigation.
void	SetKeyInputFocus ()
bool	HasKeyInputFocus ()
void	ClearKeyInputFocus ()
void	SetAsKeyboardFocusGroup (bool isFocusGroup)
	Sets whether this control is a focus group for keyboard navigation.
bool	IsKeyboardFocusGroup ()
	Gets whether this control is a focus group for keyboard navigation.
Toolkit::Control::KeyEventSignalType &	KeyEventSignal ()
Toolkit::Control::KeyInputFocusSignalType &	KeyInputFocusGainedSignal ()
Toolkit::Control::KeyInputFocusSignalType &	KeyInputFocusLostSignal ()
virtual void	OnInitialize ()
	This method is called after the Control has been initialized.
virtual void	OnControlChildAdd (Actor &child)
	Called whenever an Actor is added to the control.
virtual void	OnControlChildRemove (Actor &child)
	Called whenever an Actor is removed from the control.
virtual void	OnStyleChange (Toolkit::StyleManager styleManager, StyleChange::Type change)
	This method should be overridden by deriving classes requiring notifications when the style changes.
virtual bool	OnAccessibilityActivated ()
	This method is called when the control is accessibility activated.
virtual bool	OnAccessibilityPan (PanGesture gesture)
	This method should be overridden by deriving classes when they wish to respond the accessibility pan gesture.
virtual bool	OnAccessibilityTouch (const TouchEvent &touchEvent)
	This method should be overridden by deriving classes when they wish to respond the accessibility touch event.
virtual bool	OnAccessibilityValueChange (bool isIncrease)
	This method should be overridden by deriving classes when they wish to respond the accessibility up and down action (i.e. value change of slider control).
virtual bool	OnAccessibilityZoom ()
	This method should be overridden by deriving classes when they wish to respond the accessibility zoom action.
virtual void	OnKeyInputFocusGained ()
	Called when the control gains key input focus.
virtual void	OnKeyInputFocusLost ()
	Called when the control loses key input focus.
virtual Actor	GetNextKeyboardFocusableActor (Actor currentFocusedActor, Toolkit::Control::KeyboardFocus::Direction direction, bool loopEnabled)
	Gets the next keyboard focusable actor in this control towards the given direction.
virtual void	OnKeyboardFocusChangeCommitted (Actor commitedFocusableActor)
	Informs this control that its chosen focusable actor will be focused.
virtual bool	OnKeyboardEnter ()
	This method is called when the control has enter pressed on it.
virtual void	OnPinch (const PinchGesture &pinch)
	Called whenever a pinch gesture is detected on this control.
virtual void	OnPan (const PanGesture &pan)
	Called whenever a pan gesture is detected on this control.
virtual void	OnTap (const TapGesture &tap)
	Called whenever a tap gesture is detected on this control.
virtual void	OnLongPress (const LongPressGesture &longPress)
	Called whenever a long press gesture is detected on this control.
virtual void	SignalConnected (SlotObserver slotObserver, CallbackBase callback)
virtual void	SignalDisconnected (SlotObserver slotObserver, CallbackBase callback)
virtual Extension *	GetControlExtension ()
	Retrieve the extension for this control.
Static Public Member Functions
static Toolkit::Control	New ()
	Forward declare future extension interface.
Protected Types
enum	ControlBehaviour
Protected Member Functions
void	EmitKeyInputFocusSignal (bool focusGained)
	Emits KeyInputFocusGained signal if true else emits KeyInputFocusLost signal.
virtual void	OnStageConnection (int depth)
virtual void	OnStageDisconnection ()
virtual void	OnChildAdd (Actor &child)
virtual void	OnChildRemove (Actor &child)
virtual void	OnSizeSet (const Vector3 &targetSize)
virtual void	OnSizeAnimation (Animation &animation, const Vector3 &targetSize)
virtual bool	OnTouchEvent (const TouchEvent &event)
virtual bool	OnHoverEvent (const HoverEvent &event)
virtual bool	OnKeyEvent (const KeyEvent &event)
virtual bool	OnWheelEvent (const WheelEvent &event)
virtual void	OnRelayout (const Vector2 &size, RelayoutContainer &container)
virtual void	OnSetResizePolicy (ResizePolicy::Type policy, Dimension::Type dimension)
virtual Vector3	GetNaturalSize ()
virtual float	CalculateChildSize (const Dali::Actor &child, Dimension::Type dimension)
virtual float	GetHeightForWidth (float width)
virtual float	GetWidthForHeight (float height)
virtual bool	RelayoutDependentOnChildren (Dimension::Type dimension=Dimension::ALL_DIMENSIONS)
virtual void	OnCalculateRelayoutSize (Dimension::Type dimension)
virtual void	OnLayoutNegotiated (float size, Dimension::Type dimension)
	Control (ControlBehaviour behaviourFlags)
	Control constructor.
void	Initialize ()
	Second phase initialization.
Static Protected Attributes
static const int	CONTROL_BEHAVIOUR_FLAG_COUNT = Log< LAST_CONTROL_BEHAVIOUR_FLAG - 1 >::value + 1
	Total count of flags.

Detailed Description

This is the internal base class for all controls.

It will provide some common functionality required by all controls. Implements ConnectionTrackerInterface so that signals (typically connected to member functions) will be disconnected automatically when the control is destroyed.

Since :: 2.4

Member Enumeration Documentation

enum Dali::Toolkit::Internal::Control::ControlBehaviour [protected]

Enumerator:

REQUIRES_STYLE_CHANGE_SIGNALS

True if needs to monitor style change signals such as theme/font change.

Since :: 2.4

REQUIRES_KEYBOARD_NAVIGATION_SUPPORT

True if needs to support keyboard navigation.

Since :: 2.4

Constructor & Destructor Documentation

virtual Dali::Toolkit::Internal::Control::~Control ( ) [virtual]

Virtual destructor.

Since :: 2.4

Dali::Toolkit::Internal::Control::Control ( ControlBehaviour behaviourFlags ) [protected]

Control constructor.

Since :: 2.4

Parameters:

[in] behaviourFlags Behavioural flags from ControlBehaviour enum

Member Function Documentation

virtual float Dali::Toolkit::Internal::Control::CalculateChildSize	(	const Dali::Actor &	child,
		Dimension::Type	dimension
	)		`[protected, virtual]`

Calculate the size for a child.

Since :: 2.4

Parameters:

[in]	child	The child actor to calculate the size for
[in]	dimension	The dimension to calculate the size for. E.g. width or height.

Returns:: Return the calculated size for the given dimension.

Implements Dali::CustomActorImpl.

void Dali::Toolkit::Internal::Control::ClearBackground ( )

Clears the background.

Since :: 2.4

void Dali::Toolkit::Internal::Control::ClearKeyInputFocus ( )

Once an actor is Set to receive key input focus this function is called to stop it receiving key events.

A check is performed to ensure it was previously set, if this check fails then nothing is done.

Since :: 2.4

Precondition:: The Actor has been initialized.

void Dali::Toolkit::Internal::Control::DisableGestureDetection ( Gesture::Type type )

Allows deriving classes to disable any of the gesture detectors.

Like EnableGestureDetection, this can also be called using bitwise or.

Since :: 2.4

Parameters:

[in] type The gesture type(s) to disable

See also:: EnableGetureDetection

void Dali::Toolkit::Internal::Control::EmitKeyInputFocusSignal ( bool focusGained ) [protected]

Emits KeyInputFocusGained signal if true else emits KeyInputFocusLost signal.

Should be called last by the control after it acts on the Input Focus change.

Since :: 2.4

Parameters:

[in] focusGained True if gained, False if lost

void Dali::Toolkit::Internal::Control::EnableGestureDetection ( Gesture::Type type )

Allows deriving classes to enable any of the gesture detectors that are available.

Gesture detection can be enabled one at a time or in bitwise format as shown:

 EnableGestureDetection(Gesture::Type(Gesture::Pinch | Gesture::Tap | Gesture::Pan));

Since :: 2.4

Parameters:

[in] type The gesture type(s) to enable

Vector4 Dali::Toolkit::Internal::Control::GetBackgroundColor ( ) const

Retrieves the background color of the control.

Since :: 2.4

Returns:: The background color of the control

virtual Extension* Dali::Toolkit::Internal::Control::GetControlExtension ( ) [virtual]

Retrieve the extension for this control.

Since :: 2.4

Returns:: The extension if available, NULL otherwise

virtual float Dali::Toolkit::Internal::Control::GetHeightForWidth ( float width ) [protected, virtual]

This method is called during size negotiation when a height is required for a given width.

Derived classes should override this if they wish to customize the height returned.

Since :: 2.4

Parameters:

width Width to use.

Returns:: The height based on the width.

Implements Dali::CustomActorImpl.

LongPressGestureDetector Dali::Toolkit::Internal::Control::GetLongPressGestureDetector ( ) const

If deriving classes wish to fine tune long press gesture detection then they can access the gesture detector through this API and modify the detection.

Since :: 2.4

Returns:: The long press gesture detector

Precondition:: Long press detection should have been enabled via EnableGestureDetection().

See also:: EnableGestureDetection

virtual Vector3 Dali::Toolkit::Internal::Control::GetNaturalSize ( ) [protected, virtual]

Return the natural size of the actor.

Since :: 2.4

Returns:: The actor's natural size

Implements Dali::CustomActorImpl.

virtual Actor Dali::Toolkit::Internal::Control::GetNextKeyboardFocusableActor	(	Actor	currentFocusedActor,
		Toolkit::Control::KeyboardFocus::Direction	direction,
		bool	loopEnabled
	)		`[virtual]`

Gets the next keyboard focusable actor in this control towards the given direction.

A control needs to override this function in order to support two dimensional keyboard navigation.

Since :: 2.4

Parameters:

[in]	currentFocusedActor	The current focused actor
[in]	direction	The direction to move the focus towards
[in]	loopEnabled	Whether the focus movement should be looped within the control.

Returns:: The next keyboard focusable actor in this control or an empty handle if no actor can be focused.

PanGestureDetector Dali::Toolkit::Internal::Control::GetPanGestureDetector ( ) const

If deriving classes wish to fine tune pan gesture detection then they can access the gesture detector through this API and modify the detection.

Since :: 2.4

Returns:: The pan gesture detector

Precondition:: Pan detection should have been enabled via EnableGestureDetection().

See also:: EnableGestureDetection

PinchGestureDetector Dali::Toolkit::Internal::Control::GetPinchGestureDetector ( ) const

If deriving classes wish to fine tune pinch gesture detection then they can access the gesture detector through this API and modify the detection.

Since :: 2.4

Returns:: The pinch gesture detector

Precondition:: Pinch detection should have been enabled via EnableGestureDetection().

See also:: EnableGestureDetection

const std::string& Dali::Toolkit::Internal::Control::GetStyleName ( ) const

Retrieves the name of the style to be applied to the control (if any).

Since :: 2.4

Returns:: A string matching a style or an empty string.

TapGestureDetector Dali::Toolkit::Internal::Control::GetTapGestureDetector ( ) const

If deriving classes wish to fine tune tap gesture detection then they can access the gesture detector through this API and modify the detection.

Since :: 2.4

Returns:: The tap gesture detector

Precondition:: Tap detection should have been enabled via EnableGestureDetection().

See also:: EnableGestureDetection

virtual float Dali::Toolkit::Internal::Control::GetWidthForHeight ( float height ) [protected, virtual]

This method is called during size negotiation when a width is required for a given height.

Derived classes should override this if they wish to customize the width returned.

Since :: 2.4

Parameters:

height Height to use.

Returns:: The width based on the width

Implements Dali::CustomActorImpl.

bool Dali::Toolkit::Internal::Control::HasKeyInputFocus ( )

Quries whether the control has key input focus.

Since :: 2.4

Returns:: True if this control has keyboard input focus

Precondition:: The Control has been initialized.; The Control should be on the stage before setting keyboard focus.

Note:: The control can be set to have the focus and still not receive all the key events if another control has over ridden it. As the key input focus mechanism works like a stack, the top most control receives all the key events, and passes on the unhandled events to the controls below in the stack. A control in the stack will regain key input focus when there are no more controls above it in the focus stack. To query for the conrol which is on top of the focus stack use Dali::Toolkit::KeyInputFocusManager::GetCurrentKeyboardFocusActor().

void Dali::Toolkit::Internal::Control::Initialize ( ) [protected]

Second phase initialization.

Since :: 2.4

bool Dali::Toolkit::Internal::Control::IsKeyboardFocusGroup ( )

Gets whether this control is a focus group for keyboard navigation.

Since :: 2.4

Returns:: True if this control is set as a focus group for keyboard navigation.

bool Dali::Toolkit::Internal::Control::IsKeyboardNavigationSupported ( )

Gets whether this control supports two dimensional keyboard navigation.

Since :: 2.4

Returns:: True if this control supports two dimensional keyboard navigation.

Toolkit::Control::KeyEventSignalType& Dali::Toolkit::Internal::Control::KeyEventSignal ( )

This signal is emitted when key event is received.

A callback of the following type may be connected:

   bool YourCallbackName(Control control, const KeyEvent& event);

The return value of True, indicates that the event should be consumed. Otherwise the signal will be emitted on the next parent of the actor.

Since :: 2.4

Returns:: The signal to connect to

Precondition:: The Control has been initialized.

Toolkit::Control::KeyInputFocusSignalType& Dali::Toolkit::Internal::Control::KeyInputFocusGainedSignal ( )

This signal is emitted when the control gets Key Input Focus.

A callback of the following type may be connected:

   bool YourCallbackName( Control control );

The return value of True, indicates that the event should be consumed. Otherwise the signal will be emitted on the next parent of the actor.

Since :: 2.4

Returns:: The signal to connect to

Precondition:: The Control has been initialized.

Toolkit::Control::KeyInputFocusSignalType& Dali::Toolkit::Internal::Control::KeyInputFocusLostSignal ( )

This signal is emitted when the control loses Key Input Focus which could be due to it being gained by another Control or Actor or just cleared from this control as no longer required.

A callback of the following type may be connected:

   bool YourCallbackName( Control control );

The return value of True, indicates that the event should be consumed. Otherwise the signal will be emitted on the next parent of the actor.

Since :: 2.4

Returns:: The signal to connect to

Precondition:: The Control has been initialized.

static Toolkit::Control Dali::Toolkit::Internal::Control::New ( ) [static]

Forward declare future extension interface.

Create a new ControlImpl instance that does not require touch by default.

If touch is required then the user can connect to this class' touch signal.

Since :: 2.4

Returns:: A handle to the ControlImpl instance

virtual bool Dali::Toolkit::Internal::Control::OnAccessibilityActivated ( ) [virtual]

This method is called when the control is accessibility activated.

Derived classes should override this to perform custom accessibility activation.

Since :: 2.4

Returns:: True if this control can perform accessibility activation.

virtual bool Dali::Toolkit::Internal::Control::OnAccessibilityPan ( PanGesture gesture ) [virtual]

This method should be overridden by deriving classes when they wish to respond the accessibility pan gesture.

Since :: 2.4

Parameters:

[in] gesture The pan gesture

Returns:: True if the pan gesture has been consumed by this control.

virtual bool Dali::Toolkit::Internal::Control::OnAccessibilityTouch ( const TouchEvent & touchEvent ) [virtual]

This method should be overridden by deriving classes when they wish to respond the accessibility touch event.

Since :: 2.4

Parameters:

[in] touchEvent The touch event

Returns:: True if the touch event has been consumed by this control.

virtual bool Dali::Toolkit::Internal::Control::OnAccessibilityValueChange ( bool isIncrease ) [virtual]

This method should be overridden by deriving classes when they wish to respond the accessibility up and down action (i.e. value change of slider control).

Since :: 2.4

Parameters:

[in] isIncrease Whether the value should be increased or decreased

Returns:: True if the value changed action has been consumed by this control.

virtual bool Dali::Toolkit::Internal::Control::OnAccessibilityZoom ( ) [virtual]

This method should be overridden by deriving classes when they wish to respond the accessibility zoom action.

Since :: 2.4

Returns:: True if the zoom action has been consumed by this control.

virtual void Dali::Toolkit::Internal::Control::OnCalculateRelayoutSize ( Dimension::Type dimension ) [protected, virtual]

Virtual method to notify deriving classes that relayout dependencies have been met and the size for this object is about to be calculated for the given dimension.

Since :: 2.4

Parameters:

dimension The dimension that is about to be calculated

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnChildAdd ( Actor & child ) [protected, virtual]

Called after a child has been added to the owning actor.

Since :: 2.4

Parameters:

[in] child The child which has been added

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnChildRemove ( Actor & child ) [protected, virtual]

Called after a child has been removed from the owning actor.

Since :: 2.4

Parameters:

[in] child The child being removed

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnControlChildAdd ( Actor & child ) [virtual]

Called whenever an Actor is added to the control.

Could be overridden by derived classes.

Since :: 2.4

Parameters:

[in] child The added actor

virtual void Dali::Toolkit::Internal::Control::OnControlChildRemove ( Actor & child ) [virtual]

Called whenever an Actor is removed from the control.

Could be overridden by derived classes.

Since :: 2.4

Parameters:

[in] child The removed actor

virtual bool Dali::Toolkit::Internal::Control::OnHoverEvent ( const HoverEvent & event ) [protected, virtual]

Called after a hover-event is received by the owning actor.

Since :: 2.4

Parameters:

[in] event The hover event

Returns:: True if the event should be consumed.

Note:: CustomActorImpl::REQUIRES_HOVER_EVENTS must be enabled during construction. See CustomActorImpl::CustomActorImpl( ActorFlags flags ).

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnInitialize ( ) [virtual]

This method is called after the Control has been initialized.

Derived classes should do any second phase initialization by overriding this method.

Since :: 2.4

virtual bool Dali::Toolkit::Internal::Control::OnKeyboardEnter ( ) [virtual]

This method is called when the control has enter pressed on it.

Derived classes should override this to perform custom actions.

Since :: 2.4

Returns:: True if this control supported this action.

virtual void Dali::Toolkit::Internal::Control::OnKeyboardFocusChangeCommitted ( Actor commitedFocusableActor ) [virtual]

Informs this control that its chosen focusable actor will be focused.

This allows the application to preform any actions if wishes before the focus is actually moved to the chosen actor.

Since :: 2.4

Parameters:

[in] commitedFocusableActor The commited focusable actor

virtual bool Dali::Toolkit::Internal::Control::OnKeyEvent ( const KeyEvent & event ) [protected, virtual]

Called after a key-event is received by the actor that has had its focus set.

Since :: 2.4

Parameters:

[in] event the Key Event

Returns:: True if the event should be consumed.

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnKeyInputFocusGained ( ) [virtual]

Called when the control gains key input focus.

Should be overridden by derived classes if they need to customize what happens when focus is gained.

Since :: 2.4

virtual void Dali::Toolkit::Internal::Control::OnKeyInputFocusLost ( ) [virtual]

Called when the control loses key input focus.

Should be overridden by derived classes if they need to customize what happens when focus is lost.

Since :: 2.4

virtual void Dali::Toolkit::Internal::Control::OnLayoutNegotiated	(	float	size,
		Dimension::Type	dimension
	)		`[protected, virtual]`

Virtual method to notify deriving classes that the size for a dimension has just been negotiated.

Since :: 2.4

Parameters:

[in]	size	The new size for the given dimension
[in]	dimension	The dimension that was just negotiated

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnLongPress ( const LongPressGesture & longPress ) [virtual]

Called whenever a long press gesture is detected on this control.

This should be overridden by deriving classes when long press detection is enabled.

Since :: 2.4

Parameters:

[in] longPress The long press gesture

Note:: There is no default behaviour associated with a long press.; Long press detection should be enabled via EnableGestureDetection().

See also:: EnableGestureDetection

virtual void Dali::Toolkit::Internal::Control::OnPan ( const PanGesture & pan ) [virtual]

Called whenever a pan gesture is detected on this control.

This should be overridden by deriving classes when pan detection is enabled.

Since :: 2.4

Parameters:

[in] pan The pan gesture

Note:: There is no default behaviour with panning.; Pan detection should be enabled via EnableGestureDetection().

See also:: EnableGestureDetection

virtual void Dali::Toolkit::Internal::Control::OnPinch ( const PinchGesture & pinch ) [virtual]

Called whenever a pinch gesture is detected on this control.

This can be overridden by deriving classes when pinch detection is enabled. The default behaviour is to scale the control by the pinch scale.

Since :: 2.4

Parameters:

[in] pinch The pinch gesture

Note:: If overridden, then the default behaviour will not occur.; Pinch detection should be enabled via EnableGestureDetection().

See also:: EnableGestureDetection

virtual void Dali::Toolkit::Internal::Control::OnRelayout	(	const Vector2 &	size,
		RelayoutContainer &	container
	)		`[protected, virtual]`

Called after the size negotiation has been finished for this control.

The control is expected to assign this given size to itself/its children.

Should be overridden by derived classes if they need to layout actors differently after certain operations like add or remove actors, resize or after changing specific properties.

Since :: 2.4

Parameters:

[in]	size	The allocated size.
[in,out]	container	The control should add actors to this container that it is not able to allocate a size for.

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnSetResizePolicy	(	ResizePolicy::Type	policy,
		Dimension::Type	dimension
	)		`[protected, virtual]`

Notification for deriving classes.

Since :: 2.4

Parameters:

[in]	policy	The policy being set
[in]	dimension	The dimension the policy is being set for

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnSizeAnimation	(	Animation &	animation,
		const Vector3 &	targetSize
	)		`[protected, virtual]`

Called when the owning actor's size is animated e.g. using Animation::AnimateTo( Property( actor, Actor::Property::SIZE ), ... ).

Since :: 2.4

Parameters:

[in]	animation	The object which is animating the owning actor.
[in]	targetSize	The target size. Note that this target size may not match the size returned via Actor::GetSize.

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnSizeSet ( const Vector3 & targetSize ) [protected, virtual]

Called when the owning actor's size is set e.g. using Actor::SetSize().

Since :: 2.4

Parameters:

[in] targetSize The target size. Note that this target size may not match the size returned via Actor::GetSize.

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnStageConnection ( int depth ) [protected, virtual]

Called after the actor has been connected to the stage.

When an actor is connected, it will be directly or indirectly parented to the root Actor.

Since :: 2.4

Parameters:

[in] depth The depth in the hierarchy for the actor

Note:: The root Actor is provided automatically by Dali::Stage, and is always considered to be connected. When the parent of a set of actors is connected to the stage, then all of the children will received this callback. For the following actor tree, the callback order will be A, B, D, E, C, and finally F.

       A (parent)
      / \
     B   C
    / \   \
   D   E   F

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnStageDisconnection ( ) [protected, virtual]

Called after the actor has been disconnected from Stage.

If an actor is disconnected it either has no parent, or is parented to a disconnected actor.

Since :: 2.4

Note:: When the parent of a set of actors is disconnected to the stage, then all of the children will received this callback, starting with the leaf actors. For the following actor tree, the callback order will be D, E, B, F, C, and finally A.

       A (parent)
      / \
     B   C
    / \   \
   D   E   F

Implements Dali::CustomActorImpl.

virtual void Dali::Toolkit::Internal::Control::OnStyleChange	(	Toolkit::StyleManager	styleManager,
		StyleChange::Type	change
	)		`[virtual]`

This method should be overridden by deriving classes requiring notifications when the style changes.

Since :: 2.4

Parameters:

[in]	styleManager	The StyleManager object
[in]	change	Information denoting what has changed.

virtual void Dali::Toolkit::Internal::Control::OnTap ( const TapGesture & tap ) [virtual]

Called whenever a tap gesture is detected on this control.

This should be overridden by deriving classes when tap detection is enabled.

Since :: 2.4

Parameters:

[in] tap The tap gesture

Note:: There is no default behaviour with a tap.; Tap detection should be enabled via EnableGestureDetection().

See also:: EnableGestureDetection

virtual bool Dali::Toolkit::Internal::Control::OnTouchEvent ( const TouchEvent & event ) [protected, virtual]

Called after a touch-event is received by the owning actor.

Since :: 2.4

Parameters:

[in] event The touch event

Returns:: True if the event should be consumed.

Note:: CustomActorImpl::REQUIRES_TOUCH_EVENTS must be enabled during construction. See CustomActorImpl::CustomActorImpl( ActorFlags flags ).

Implements Dali::CustomActorImpl.

virtual bool Dali::Toolkit::Internal::Control::OnWheelEvent ( const WheelEvent & event ) [protected, virtual]

Called after a wheel-event is received by the owning actor.

Since :: 2.4

Parameters:

[in] event The wheel event

Returns:: True if the event should be consumed.

Note:: CustomActorImpl::REQUIRES_WHEEL_EVENTS must be enabled during construction. See CustomActorImpl::CustomActorImpl( ActorFlags flags ).

Implements Dali::CustomActorImpl.

virtual bool Dali::Toolkit::Internal::Control::RelayoutDependentOnChildren ( Dimension::Type dimension = Dimension::ALL_DIMENSIONS ) [protected, virtual]

Determine if this actor is dependent on it's children for relayout.

Since :: 2.4

Parameters:

dimension The dimension(s) to check for

Returns:: Return if the actor is dependent on it's children.

Implements Dali::CustomActorImpl.

void Dali::Toolkit::Internal::Control::SetAsKeyboardFocusGroup ( bool isFocusGroup )

Sets whether this control is a focus group for keyboard navigation.

(i.e. the scope of keyboard focus movement can be limitied to its child actors). The control is not a focus group by default.

Since :: 2.4

Parameters:

[in] isFocusGroup Whether this control is set as a focus group for keyboard navigation.

void Dali::Toolkit::Internal::Control::SetBackgroundColor ( const Vector4 & color )

Sets the background color of the control.

Since :: 2.4

Parameters:

[in] color The required background color of the control

Note:: The background color fully blends with the actor color.

void Dali::Toolkit::Internal::Control::SetBackgroundImage ( Image image )

Sets an image as the background of the control.

The color of this image is blended with the background color

See also:: SetBackgroundColor.

Since :: 2.4

Parameters:

[in] image The image to set as the background

void Dali::Toolkit::Internal::Control::SetKeyboardNavigationSupport ( bool isSupported )

Sets whether this control supports two dimensional keyboard navigation (i.e. whether it knows how to handle the keyboard focus movement between its child actors).

The control doesn't support it by default.

Since :: 2.4

Parameters:

[in] isSupported Whether this control supports two dimensional keyboard navigation.

void Dali::Toolkit::Internal::Control::SetKeyInputFocus ( )

This sets the control to receive key events.

The key event can originate from a virtual or physical keyboard.

Since :: 2.4

Precondition:: The Control has been initialized.; The Control should be on the stage before setting keyboard focus.

void Dali::Toolkit::Internal::Control::SetStyleName ( const std::string & styleName )

Sets the name of the style to be applied to the control.

Since :: 2.4

Parameters:

[in] styleName A string matching a style described in a stylesheet.

virtual void Dali::Toolkit::Internal::Control::SignalConnected	(	SlotObserver *	slotObserver,
		CallbackBase *	callback
	)		`[virtual]`

Called when a signal is connected.

Since :: 2.4

Parameters:

[in]	slotObserver	The slot observer i.e. a signal. Ownership is not passed.
[in]	callback	The call back. Ownership is not passed.

Implements Dali::ConnectionTrackerInterface.

virtual void Dali::Toolkit::Internal::Control::SignalDisconnected	(	SlotObserver *	slotObserver,
		CallbackBase *	callback
	)		`[virtual]`

This method is called when the signal is disconnecting.

Since :: 2.4

Parameters:

[in]	slotObserver	The signal that has disconnected.
[in]	callback	The callback attached to the signal disconnected.

Implements Dali::SignalObserver.

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Static Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation