X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git;a=blobdiff_plain;f=dali-toolkit%2Finternal%2Ftext%2Fdecorator%2Ftext-decorator.h;h=ae90e90f2c5b3bbe26754b3e6042f5e114ebe7a0;hp=e341e2b4c8640b71e6ddeda8c0746cf975bdaf13;hb=dbe59842bb6226eaccfc27f189e35c7614c6d814;hpb=620ac79821b89142af1926f3577c7fa003f16ad3 diff --git a/dali-toolkit/internal/text/decorator/text-decorator.h b/dali-toolkit/internal/text/decorator/text-decorator.h index e341e2b..ae90e90 100644 --- a/dali-toolkit/internal/text/decorator/text-decorator.h +++ b/dali-toolkit/internal/text/decorator/text-decorator.h @@ -22,23 +22,19 @@ #include #include #include -#include + +// INTERNAL INCLUDES +#include namespace Dali { -class Image; -class Vector2; -class Vector4; +struct Vector2; +struct Vector4; namespace Toolkit { -namespace Internal -{ -class Control; -} - namespace Text { @@ -85,6 +81,8 @@ enum HandleType GRAB_HANDLE, LEFT_SELECTION_HANDLE, RIGHT_SELECTION_HANDLE, + LEFT_SELECTION_HANDLE_MARKER, + RIGHT_SELECTION_HANDLE_MARKER, HANDLE_TYPE_COUNT }; @@ -98,26 +96,40 @@ enum HandleType * * 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 Add a decoration to the parent UI control. + * + * @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. @@ -127,17 +139,19 @@ public: * @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 HandleEvent( HandleType handleType, HandleState 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. @@ -235,7 +249,7 @@ public: * @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. @@ -284,6 +298,20 @@ public: float GetCursorBlinkDuration() const; /** + * @brief Sets the width of the cursors. + * + * @param[in] width The width of the cursor in pixels. + */ + void SetCursorWidth( int width ); + + /** + * @brief Retrieves the width of the cursors. + * + * @return The width of the cursors in pixels. + */ + int GetCursorWidth() const; + + /** * @brief Sets whether a handle is active. * * @param[in] handleType One of the handles. @@ -321,6 +349,20 @@ public: Dali::Image GetHandleImage( HandleType handleType, HandleImageType handleImageType ) const; /** + * @brief Sets the color of the handles + * + * @param[in] color The color to use. + */ + void SetHandleColor( const Vector4& color ); + + /** + * @brief Retrieves the handles color. + * + * @return The color of the handles. + */ + const Vector4& GetHandleColor() const; + + /** * @brief Sets the position of a selection handle. * * @param[in] handleType The handle to set. @@ -341,6 +383,23 @@ public: 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. + */ + const Vector2& GetPosition( HandleType handleType ) const; + + /** + * @brief Swaps the selection handle's images. + * + * This method is called by the text controller to swap the handles + * when the start index is bigger than the end one. + */ + void SwapSelectionHandlesEnabled( bool enable ); + + /** * @brief Adds a quad to the existing selection highlights. * * @param[in] x1 The top-left x position. @@ -358,18 +417,25 @@ public: /** * @brief Sets the selection highlight color. * - * @param[in] image The image to use. + * @param[in] color The color to use. */ void SetHighlightColor( const Vector4& color ); /** * @brief Retrieves the selection highlight color. * - * @return The image. + * @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 */ @@ -383,6 +449,18 @@ public: 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. @@ -416,18 +494,9 @@ public: float GetScrollSpeed() const; /** - * @brief Sets the scroll interval. - * - * @param[in] seconds The scroll interval in seconds. - */ - void SetScrollTickInterval( float seconds ); - - /** - * @brief Retrieves the scroll interval. - * - * @return The scroll interval. + * @brief Notifies the decorator the whole text has been scrolled. */ - float GetScrollTickInterval() const; + void NotifyEndOfScroll(); protected: @@ -440,10 +509,11 @@ private: /** * @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 );