#include <dali/public-api/object/ref-object.h>
#include <dali/public-api/math/rect.h>
+// INTERNAL INCLUDES
+#include <dali-toolkit/devel-api/controls/text-controls/text-selection-popup.h>
+
namespace Dali
{
-class Image;
-class Vector2;
-class Vector4;
+struct Vector2;
+struct Vector4;
namespace Toolkit
{
-namespace Internal
-{
-class Control;
-}
-
namespace Text
{
ACTIVE_CURSOR_BOTH ///< Both primary and secondary cursor are active
};
-// The state information for grab handle events
-enum GrabHandleState
+// The state information for handle events.
+enum HandleState
{
- GRAB_HANDLE_TAPPED,
- GRAB_HANDLE_PRESSED,
- GRAB_HANDLE_RELEASED
+ HANDLE_TAPPED,
+ HANDLE_PRESSED,
+ HANDLE_RELEASED,
+ HANDLE_SCROLLING,
+ HANDLE_STOP_SCROLLING
};
-// The set the selection-handle positions etc.
-enum SelectionHandle
+// Used to set different handle images
+enum HandleImageType
{
- PRIMARY_SELECTION_HANDLE,
- SECONDARY_SELECTION_HANDLE,
- SELECTION_HANDLE_COUNT
+ HANDLE_IMAGE_PRESSED,
+ HANDLE_IMAGE_RELEASED,
+ HANDLE_IMAGE_TYPE_COUNT
};
-enum SelectionHandleState
+// Types of handles.
+enum HandleType
{
- SELECTION_HANDLE_PRESSED,
- SELECTION_HANDLE_RELEASED
+ GRAB_HANDLE,
+ LEFT_SELECTION_HANDLE,
+ RIGHT_SELECTION_HANDLE,
+ LEFT_SELECTION_HANDLE_MARKER,
+ RIGHT_SELECTION_HANDLE_MARKER,
+ HANDLE_TYPE_COUNT
};
/**
*
* Selection handles will be flipped around to ensure they do not exceed the Decoration Bounding Box. ( Stay visible ).
*
- * Decorator components forward input events to a controller class through an observer interface.
+ * Decorator components forward input events to a controller class through an interface.
* The controller is responsible for selecting which components are active.
*/
class Decorator : public RefObject
{
public:
- class Observer
+ class ControllerInterface
{
public:
/**
* @brief Constructor.
*/
- Observer() {};
+ ControllerInterface() {};
/**
* @brief Virtual destructor.
*/
- virtual ~Observer() {};
+ virtual ~ControllerInterface() {};
+
+ /**
+ * @brief Query the target size of the UI control.
+ *
+ * @param[out] targetSize The size of the UI control the decorator is adding it's decorations to.
+ */
+ virtual void GetTargetSize( Vector2& targetSize ) = 0;
/**
- * @brief An input event from the grab handle.
+ * @brief Add a decoration to the parent UI control.
*
- * @param[in] state The grab handle state.
+ * @param[in] decoration The actor displaying a decoration.
+ */
+ virtual void AddDecoration( Actor& actor, bool needsClipping ) = 0;
+
+ /**
+ * @brief An input event from one of the handles.
+ *
+ * @param[in] handleType The handle's type.
+ * @param[in] state The handle's state.
* @param[in] x The x position relative to the top-left of the parent control.
* @param[in] y The y position relative to the top-left of the parent control.
*/
- virtual void GrabHandleEvent( GrabHandleState state, float x, float y ) = 0;
+ virtual void DecorationEvent( HandleType handleType, HandleState state, float x, float y ) = 0;
};
/**
* @brief Create a new instance of a Decorator.
*
- * @param[in] parent Decorations will be added to this parent control.
- * @param[in] observer A class which receives input events from Decorator components.
+ * @param[in] controller The controller which receives input events from Decorator components.
+ * @param[in] callbackInterface The text popup callback interface which receives the button click callbacks.
+ *
* @return A pointer to a new Decorator.
*/
- static DecoratorPtr New( Dali::Toolkit::Internal::Control& parent, Observer& observer );
+ static DecoratorPtr New( ControllerInterface& controller,
+ TextSelectionPopupCallbackInterface& callbackInterface );
/**
* @brief Set the bounding box which handles, popup and similar decorations will not exceed.
* @brief Retrieve the bounding box origin and dimensions.
*
* default is set once control is added to stage, before this the return vector will be Vector4:ZERO
- * @return Rect<int> the bounding box origin, width and height
+ * @param[out] boundingBox The bounding box origin, width and height.
*/
- const Rect<int>& GetBoundingBox() const;
+ void GetBoundingBox( Rect<int>& boundingBox ) const;
/**
* @brief The decorator waits until a relayout before creating actors etc.
*
* @param[in] size The size of the parent control after size-negotiation.
- * @param[in] scrollPosition The cursor, grab-handle positions etc. should be offset by this.
*/
- void Relayout( const Dali::Vector2& size, const Vector2& scrollPosition );
+ void Relayout( const Dali::Vector2& size );
+
+ /**
+ * @brief Updates the decorator's actor positions after scrolling.
+ *
+ * @param[in] scrollOffset The scroll offset.
+ */
+ void UpdatePositions( const Vector2& scrollOffset );
/**
* @brief Sets which of the cursors are active.
* @param[in] cursor The cursor to set.
* @param[in] x The x position relative to the top-left of the parent control.
* @param[in] y The y position relative to the top-left of the parent control.
- * @param[in] height The logical height of the cursor.
+ * @param[in] cursorHeight The logical height of the cursor.
+ * @param[in] lineHeight The logical height of the line.
*/
- void SetPosition( Cursor cursor, float x, float y, float height );
+ void SetPosition( Cursor cursor, float x, float y, float cursorHeight, float lineHeight );
/**
- * @brief Retrieves the position of a cursor.
+ * @brief Retrieves the position, height and lineHeight of a cursor.
*
* @param[in] cursor The cursor to get.
* @param[out] x The x position relative to the top-left of the parent control.
* @param[out] y The y position relative to the top-left of the parent control.
- * @param[out] height The logical height of the cursor.
+ * @param[out] cursorHeight The logical height of the cursor.
+ * @param[out] lineHeight The logical height of the line.
*/
- void GetPosition( Cursor cursor, float& x, float& y, float& height ) const;
+ void GetPosition( Cursor cursor, float& x, float& y, float& cursorHeight, float& lineHeight ) const;
+
+ /**
+ * @brief Retrieves the position of a cursor.
+ *
+ * @param[in] cursor The cursor to get.
+ *
+ * @return The position.
+ */
+ const Vector2& GetPosition( Cursor cursor ) const;
/**
* @brief Sets the color for a cursor.
* @param[in] cursor Whether this color is for the primary or secondary cursor.
* @param[in] color The color to use.
*/
- void SetColor( Cursor cursor, const Dali::Vector4& color );
+ void SetCursorColor( Cursor cursor, const Dali::Vector4& color );
/**
* @brief Retrieves the color for a cursor.
void StopCursorBlink();
/**
+ * @brief Temporarily stops the cursor from blinking.
+ */
+ void DelayCursorBlink();
+
+ /**
* @brief Set the interval between cursor blinks.
*
* @param[in] seconds The interval in seconds.
float GetCursorBlinkDuration() const;
/**
- * @brief Sets whether the grab handle is active.
+ * @brief Sets the width of the cursors.
*
- * @note The grab handle follows the cursor position set with SetPosition(Cursor, ...)
- * @param[in] active True if the grab handle should be active.
+ * @param[in] width The width of the cursor in pixels.
*/
- void SetGrabHandleActive( bool active );
+ void SetCursorWidth( int width );
/**
- * @brief Query whether the grab handle is active.
+ * @brief Retrieves the width of the cursors.
*
- * @return True if the grab handle should be active.
+ * @return The width of the cursors in pixels.
*/
- bool IsGrabHandleActive() const;
+ int GetCursorWidth() const;
/**
- * @brief Sets the image for the grab handle.
+ * @brief Sets whether a handle is active.
*
+ * @param[in] handleType One of the handles.
+ * @param[in] active True if the handle should be active.
+ */
+ void SetHandleActive( HandleType handleType,
+ bool active );
+
+ /**
+ * @brief Query whether a handle is active.
+ *
+ * @param[in] handleType One of the handles.
+ *
+ * @return True if the handle is active.
+ */
+ bool IsHandleActive( HandleType handleType ) const;
+
+ /**
+ * @brief Sets the image for one of the handles.
+ *
+ * @param[in] handleType One of the handles.
+ * @param[in] handleImageType A different image can be set for the pressed/released states.
* @param[in] image The image to use.
*/
- void SetGrabHandleImage( Dali::Image image );
+ void SetHandleImage( HandleType handleType, HandleImageType handleImageType, Dali::Image image );
/**
- * @brief Retrieves the image for the grab handle.
+ * @brief Retrieves the image for one of the handles.
+ *
+ * @param[in] handleType One of the handles.
+ * @param[in] handleImageType A different image can be set for the pressed/released states.
*
* @return The grab handle image.
*/
- Dali::Image GetGrabHandleImage() const;
+ Dali::Image GetHandleImage( HandleType handleType, HandleImageType handleImageType ) const;
/**
- * @brief Sets whether the selection handles and highlight are active.
+ * @brief Sets the color of the handles
*
- * @param[in] active True if the selection handles and highlight are active.
+ * @param[in] color The color to use.
*/
- void SetSelectionActive( bool active );
+ void SetHandleColor( const Vector4& color );
/**
- * @brief Query whether the selection handles and highlight are active.
+ * @brief Retrieves the handles color.
*
- * @return True if the selection handles and highlight are active.
+ * @return The color of the handles.
*/
- bool IsSelectionActive() const;
+ const Vector4& GetHandleColor() const;
/**
* @brief Sets the position of a selection handle.
*
- * @param[in] handle The handle to set.
+ * @param[in] handleType The handle to set.
* @param[in] x The x position relative to the top-left of the parent control.
* @param[in] y The y position relative to the top-left of the parent control.
- * @param[in] cursorHeight The logical cursor height at this position.
+ * @param[in] lineHeight The logical line height at this position.
*/
- void SetPosition( SelectionHandle handle, float x, float y, float cursorHeight );
+ void SetPosition( HandleType handleType, float x, float y, float lineHeight );
/**
* @brief Retrieves the position of a selection handle.
*
- * @param[in] handle The handle to get.
+ * @param[in] handleType The handle to get.
* @param[out] x The x position relative to the top-left of the parent control.
* @param[out] y The y position relative to the top-left of the parent control.
- * @param[out] cursorHeight The logical cursor height at this position.
+ * @param[out] lineHeight The logical line height at this position.
+ */
+ void GetPosition( HandleType handleType, float& x, float& y, float& lineHeight ) const;
+
+ /**
+ * @brief Retrieves the position of a selection handle.
+ *
+ * @param[in] handleType The handle to get.
+ *
+ * @return The position of the selection handle relative to the top-left of the parent control.
*/
- void GetPosition( SelectionHandle handle, float& x, float& y, float& cursorHeight ) const;
+ const Vector2& GetPosition( HandleType handleType ) const;
/**
- * @brief Sets the image for one of the selection handles.
+ * @brief Whether to flip vertically a handle.
*
- * @param[in] handle The selection handle.
- * @param[in] state A different image can be set for the pressed/released states.
- * @param[in] image The image to use.
+ * @param[in] handleType The handle to flip vertically.
+ * @param[in] flip Whether to flip vertically.
+ */
+ void FlipHandleVertically( HandleType handleType, bool flip );
+
+ /**
+ * @brief Retrieves whether the handle is vertically flipped.
+ *
+ * @param[in] handleType The handle to query.
+ *
+ * @return @e ture if the handle is vertically flipped.
+ */
+ bool IsHandleVerticallyFlipped( HandleType handleType ) const;
+
+ /**
+ * @brief Whether to flip the selection handles as soon as they are crossed.
+ *
+ * By default they flip when the handle is released.
+ *
+ * @param[in] enable If @e true the selection handles will flip as soon as they are crossed.
+ */
+ void FlipSelectionHandlesOnCrossEnabled( bool enable );
+
+ /**
+ * @brief Sets info to calculate the handle flip state.
+ *
+ * Sets the character's direction where the handles are pointing.
+ * It resets the decorator internal flip state when there is a new selection.
+ *
+ * @param[in] indicesSwapped Whether the selection handle indices are swapped (start > end).
+ * @param[in] left The direction of the character pointed by the primary selection handle.
+ * @param[in] right The direction of the character pointed by the secondary selection handle.
+ */
+ void SetSelectionHandleFlipState( bool indicesSwapped, bool left, bool right );
+
+ /**
+ * @brief Adds a quad to the existing selection highlights.
+ *
+ * @param[in] x1 The top-left x position.
+ * @param[in] y1 The top-left y position.
+ * @param[in] x2 The bottom-right x position.
+ * @param[in] y3 The bottom-right y position.
+ */
+ void AddHighlight( float x1, float y1, float x2, float y2 );
+
+ /**
+ * @brief Removes all of the previously added highlights.
+ */
+ void ClearHighlights();
+
+ /**
+ * @brief Sets the selection highlight color.
+ *
+ * @param[in] color The color to use.
+ */
+ void SetHighlightColor( const Vector4& color );
+
+ /**
+ * @brief Retrieves the selection highlight color.
+ *
+ * @return The color of the highlight
+ */
+ const Vector4& GetHighlightColor() const;
+
+ /**
+ * @brief Sets into the decorator the depth used to render the text.
+ *
+ * @param[in] depth The text's depth.
+ */
+ void SetTextDepth( int textDepth );
+
+ /**
+ * @brief Set the Selection Popup to show or hide via the active flaf
+ * @param[in] active true to show, false to hide
+ */
+ void SetPopupActive( bool active );
+
+ /**
+ * @brief Query whether the Selection Popup is active.
+ *
+ * @return True if the Selection Popup should be active.
+ */
+ bool IsPopupActive() const;
+
+ /**
+ * @brief Set a bit mask of the buttons to be shown by Popup
+ * @param[in] enabledButtonsBitMask from TextSelectionPopup::Buttons enum
+ */
+ void SetEnabledPopupButtons( TextSelectionPopup::Buttons& enabledButtonsBitMask );
+
+ /**
+ * @brief Get the current bit mask of buttons to be shown by Popup
+ * @return bitmask of TextSelectionPopup::Buttons
+ */
+ TextSelectionPopup::Buttons& GetEnabledPopupButtons();
+
+ /**
+ * @brief Sets the scroll threshold.
+ *
+ * It defines a square area inside the control, close to the edge.
+ * When the cursor enters this area, the decorator starts to send scroll events.
+ *
+ * @param[in] threshold The scroll threshold.
*/
- void SetImage( SelectionHandle handle, SelectionHandleState state, Dali::Image image );
+ void SetScrollThreshold( float threshold );
/**
- * @brief Retrieves the image for a selection handle.
+ * @brief Retrieves the scroll threshold.
*
- * @param[in] handle The selection handle.
- * @param[in] state A different image can be set for the pressed/released states.
- * @return The image.
+ * @retunr The scroll threshold.
*/
- Dali::Image GetImage( SelectionHandle handle, SelectionHandleState state ) const;
+ float GetScrollThreshold() const;
/**
- * @brief Show the Copy and Paste Popup
+ * @brief Sets the scroll speed.
+ *
+ * Is the distance the text is going to be scrolled during a scroll interval.
+ *
+ * @param[in] speed The scroll speed.
+ */
+ void SetScrollSpeed( float speed );
+
+ /**
+ * @brief Retrieves the scroll speed.
+ *
+ * @return The scroll speed.
*/
- void ShowPopup();
+ float GetScrollSpeed() const;
/**
- * @brief Hide the Copy and Paste Popup
+ * @brief Notifies the decorator the whole text has been scrolled.
*/
- void HidePopup();
+ void NotifyEndOfScroll();
protected:
/**
* @brief Private constructor.
- * @param[in] parent Decorations will be added to this parent control.
- * @param[in] observer A class which receives input events from Decorator components.
+ * @param[in] controller The controller which receives input events from Decorator components.
+ * @param[in] callbackInterface The text popup callback interface which receives the button click callbacks.
*/
- Decorator(Dali::Toolkit::Internal::Control& parent, Observer& observer );
+ Decorator( ControllerInterface& controller,
+ TextSelectionPopupCallbackInterface& callbackInterface );
// Undefined
Decorator( const Decorator& handle );