// EXTERNAL INCLUDES
#include <dali/public-api/adaptor-framework/style-change.h>
-#include <dali/public-api/common/vector-wrapper.h>
#include <dali/public-api/events/long-press-gesture.h>
#include <dali/public-api/events/pan-gesture.h>
#include <dali/public-api/events/pinch-gesture.h>
{
public:
+ class Extension; ///< Forward declare future extension interface
+
// Creation & Destruction
/**
virtual float GetWidthForHeight( float height );
/**
- * @copydoc Toolkit::Control::GetNaturalSize()
+ * @copydoc Toolkit::CustomActorImpl::GetNaturalSize()
*/
virtual Vector3 GetNaturalSize();
- /**
- * @brief Retrieves the current Control's size.
- *
- * @return The control's size.
- */
- const Vector3& GetControlSize() const;
-
- /**
- * @brief Retrieves the Control's size set by the Application / Control.
- *
- * @return The control's size.
- */
- const Vector3& GetSizeSet() const;
-
// Key Input
/**
/**
* @brief Sets whether this control supports two dimensional
* keyboard navigation (i.e. whether it knows how to handle the
- * keyboardn focus movement between its child actors).
+ * keyboard focus movement between its child actors).
*
* The control doesn't support it by default.
* @param[in] isSupported Whether this control supports two dimensional keyboard navigation.
*/
virtual void OnKeyboardFocusChangeCommitted(Actor commitedFocusableActor);
+ /**
+ * @brief Emits KeyInputFocusGained signal if true else emits KeyInputFocusLost signal
+ *
+ * Should be called last by the control after it acts on the Input Focus change.
+ *
+ * @param[in] focusGained True if gained, False if lost
+ */
+ void EmitKeyInputFocusSignal( bool focusGained );
+
// Actions & Signals
/**
Toolkit::Control::KeyEventSignalType& KeyEventSignal();
/**
+ * @copydoc Dali::Toolkit::Control::KeyInputFocusGainedSignal()
+ */
+ Toolkit::Control::KeyInputFocusSignalType& KeyInputFocusGainedSignal();
+
+ /**
+ * @copydoc Dali::Toolkit::Control::KeyInputFocusLostSignal()
+ */
+ Toolkit::Control::KeyInputFocusSignalType& KeyInputFocusLostSignal();
+
+ /**
* @brief Called by the KeyInputFocusManager to emit key event signals.
*
* @param[in] event The key event.
virtual void OnStageConnection();
/**
- * @brief Calls OnControlStageDisconnection() to notify derived classed.
- *
- * @see Dali::CustomActorImpl::OnStageDisconnection()
+ * @copydoc Dali::CustomActorImpl::OnStageDisconnection()
*/
virtual void OnStageDisconnection();
/**
- * @brief Sends a request to relayout this control.
- *
- * The control will be relaid out after the
- * Dali::Stage::SignalMessageQueueFlushed() signal is emitted. It
- * calls OnControlChildAdd() to notify derived classes.
- *
- * @note This method shouldn't be overridden by derived classes.
- *
- * @param[in] child The added actor.
- *
- * @see Dali::CustomActorImpl::OnChildAdd(Actor&)
+ * @copydoc Dali::CustomActorImpl::OnChildAdd(Actor&)
*/
virtual void OnChildAdd(Actor& child);
/**
- * @brief Sends a request to relayout this control.
- *
- * The control will be relaid out after the
- * Dali::Stage::SignalMessageQueueFlushed() signal is emitted. It
- * calls OnControlChildRemove() to notify derived classes.
- *
- * @note This method shouldn't be overridden by derived classes.
- *
- * @param[in] child The removed actor.
- *
- * @see Dali::CustomActorImpl::OnChildRemove(Actor&)
+ * @copydoc Dali::CustomActorImpl::OnChildRemove(Actor&)
*/
virtual void OnChildRemove(Actor& child);
/**
- * @brief It stores the size set by size negotiation and relayout.
- *
- * It also keeps a backup of the size set through the Actor's API used in the size negotiation.
- * It calls the OnControlSizeSet() to notify derived classes.
- *
- * @param[in] targetSize The new size.
- *
- * @see Dali::CustomActorImpl::OnSizeSet(const Vector3&)
+ * @copydoc Dali::CustomActorImpl::OnSizeSet(const Vector3&)
*/
virtual void OnSizeSet(const Vector3& targetSize);
*/
virtual void SignalDisconnected( SlotObserver* slotObserver, CallbackBase* callback );
+ /**
+ * Retrieve the extension for this control
+ *
+ * @return The extension if available, NULL otherwise
+ */
+ virtual Extension* GetExtension()
+ {
+ return NULL;
+ }
+
private:
// Undefined