X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=dali-toolkit%2Finternal%2Fcontrols%2Ftext-controls%2Ftext-field-impl.h;h=dbafa30e42739db9fecb906d1819361d673dd474;hb=549e79b19f4d24588121f55739f9fc53e00fcdaf;hp=c5723bd871ad6139d728760edf75fb345898cce8;hpb=60d99d04d7677a1b91d4f2fdd9e74bc5e1b5e7bf;p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git diff --git a/dali-toolkit/internal/controls/text-controls/text-field-impl.h b/dali-toolkit/internal/controls/text-controls/text-field-impl.h old mode 100755 new mode 100644 index c5723bd..223fa71 --- a/dali-toolkit/internal/controls/text-controls/text-field-impl.h +++ b/dali-toolkit/internal/controls/text-controls/text-field-impl.h @@ -2,7 +2,7 @@ #define DALI_TOOLKIT_INTERNAL_TEXT_FIELD_H /* - * Copyright (c) 2020 Samsung Electronics Co., Ltd. + * Copyright (c) 2022 Samsung Electronics Co., Ltd. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -21,32 +21,37 @@ // EXTERNAL INCLUDES #include #include +#include +#include +#include // INTERNAL INCLUDES -#include -#include +#include +#include +#include +#include #include +#include +#include #include +#include #include #include -#include -#include +#include +#include namespace Dali { - namespace Toolkit { - namespace Internal { /** * @brief A control which renders a short text string. */ -class TextField : public Control, public Text::ControlInterface, public Text::EditableControlInterface, public Text::SelectableControlInterface +class TextField : public Control, public Text::ControlInterface, public Text::EditableControlInterface, public Text::SelectableControlInterface, public Text::AnchorControlInterface { public: - /** * @copydoc Dali::Toollkit::TextField::New() */ @@ -61,7 +66,7 @@ public: * @param[in] index The property index. * @param[in] value The new property value. */ - static void SetProperty( BaseObject* object, Property::Index index, const Property::Value& value ); + static void SetProperty(BaseObject* object, Property::Index index, const Property::Value& value); /** * @brief Called to retrieve a property of an object of this type. @@ -70,7 +75,7 @@ public: * @param[in] index The property index. * @return The current value of the property. */ - static Property::Value GetProperty( BaseObject* object, Property::Index index ); + static Property::Value GetProperty(BaseObject* object, Property::Index index); /** * @copydoc Dali::Toollkit::TextField::GetInputMethodContext() @@ -86,17 +91,24 @@ public: * @return True if the signal was connected. * @post If a signal was connected, ownership of functor was passed to CallbackBase. Otherwise the caller is responsible for deleting the unused functor. */ - static bool DoConnectSignal( BaseObject* object, ConnectionTrackerInterface* tracker, const std::string& signalName, FunctorDelegate* functor ); + static bool DoConnectSignal(BaseObject* object, ConnectionTrackerInterface* tracker, const std::string& signalName, FunctorDelegate* functor); + + /** + * @brief Gets text controller + * + * @return The text controller + */ + Text::ControllerPtr GetTextController(); /** * @copydoc TextField::TextChangedSignal() */ - Toolkit::TextField::TextChangedSignalType& TextChangedSignal(); + Toolkit::TextField::TextChangedSignalType& TextChangedSignal(); /** * @copydoc TextField::MaxLengthReachedSignal() */ - Toolkit::TextField::MaxLengthReachedSignalType& MaxLengthReachedSignal(); + Toolkit::TextField::MaxLengthReachedSignalType& MaxLengthReachedSignal(); /** * @copydoc TextField::TextChangedSignal() @@ -104,18 +116,37 @@ public: Toolkit::TextField::InputStyleChangedSignalType& InputStyleChangedSignal(); /** - * @brief Called to select the whole texts. + * @copydoc TextField::AnchorClickedSignal() */ - void SelectWholeText(); + DevelTextField::AnchorClickedSignalType& AnchorClickedSignal(); /** - * @brief Called to unselect the whole texts. + * @copydoc TextField::CursorPositionChangedSignal() */ - void SelectNone(); + DevelTextField::CursorPositionChangedSignalType& CursorPositionChangedSignal(); -private: // From Control + /** + * @copydoc TextField::InputFilteredSignal() + */ + DevelTextField::InputFilteredSignalType& InputFilteredSignal(); + + /** + * @copydoc TextField::SelectionChangedSignal() + */ + DevelTextField::SelectionChangedSignalType& SelectionChangedSignal(); + + /** + * @copydoc TextField::SelectionClearedSignal() + */ + DevelTextField::SelectionClearedSignalType& SelectionClearedSignal(); /** + * @copydoc TextField::SelectionStartedSignal() + */ + DevelTextField::SelectionStartedSignalType& SelectionStartedSignal(); + +private: // From Control + /** * @copydoc Control::OnInitialize() */ void OnInitialize() override; @@ -123,7 +154,7 @@ private: // From Control /** * @copydoc Control::OnStyleChange() */ - void OnStyleChange( Toolkit::StyleManager styleManager, StyleChange::Type change ) override; + void OnStyleChange(Toolkit::StyleManager styleManager, StyleChange::Type change) override; /** * @copydoc Control::GetNaturalSize() @@ -133,12 +164,12 @@ private: // From Control /** * @copydoc Control::GetHeightForWidth() */ - float GetHeightForWidth( float width ) override; + float GetHeightForWidth(float width) override; /** * @copydoc Control::OnInitialize() */ - void OnRelayout( const Vector2& size, RelayoutContainer& container ) override; + void OnRelayout(const Vector2& size, RelayoutContainer& container) override; /** * @copydoc Control::OnKeyInputFocusGained() @@ -151,84 +182,192 @@ private: // From Control void OnKeyInputFocusLost() override; /** + * @copydoc Control::OnAccessibilityActivated() + */ + bool OnAccessibilityActivated() override; + + /** * @copydoc Control::OnTap() */ - void OnTap( const TapGesture& tap ) override; + void OnTap(const TapGesture& tap) override; /** * @copydoc Control::OnPan() */ - void OnPan( const PanGesture& gesture ) override; + void OnPan(const PanGesture& gesture) override; /** * @copydoc Control::OnLongPress() */ - void OnLongPress( const LongPressGesture& gesture ) override; + void OnLongPress(const LongPressGesture& gesture) override; /** * @copydoc Control::OnSceneConnection() */ - void OnSceneConnection( int depth ) override; + void OnSceneConnection(int depth) override; /** * @copydoc Dali::CustomActorImpl::OnKeyEvent(const KeyEvent&) */ bool OnKeyEvent(const KeyEvent& event) override; -// From ControlInterface + // From ControlInterface /** * @copydoc Text::ControlInterface::RequestTextRelayout() */ void RequestTextRelayout() override; -// From EditableControlInterface + // From EditableControlInterface + + /** + * @copydoc Text::EditableControlInterface::TextChanged() + */ + void TextInserted(unsigned int position, unsigned int length, const std::string& content) override; + + /** + * @copydoc Text::EditableControlInterface::TextDeleted() + */ + void TextDeleted(unsigned int position, unsigned int length, const std::string& content) override; /** - * @copydoc Text::ControlInterface::TextChanged() + * @copydoc Text::EditableControlInterface::CursorPositionChanged() */ - void TextChanged() override; + void CursorPositionChanged(unsigned int oldPosition, unsigned int newPosition) override; /** - * @copydoc Text::ControlInterface::MaxLengthReached() + * @copydoc Text::EditableControlInterface::TextChanged() + */ + void TextChanged(bool immediate) override; + + /** + * @copydoc Text::EditableControlInterface::MaxLengthReached() */ void MaxLengthReached() override; /** - * @copydoc Text::ControlInterface::InputStyleChanged() + * @copydoc Text::EditableControlInterface::InputStyleChanged() */ - void InputStyleChanged( Text::InputStyle::Mask inputStyleMask ) override; + void InputStyleChanged(Text::InputStyle::Mask inputStyleMask) override; /** - * @copydoc Text::ControlInterface::AddDecoration() + * @copydoc Text::SelectableControlInterface::SelectionChanged() */ - void AddDecoration( Actor& actor, bool needsClipping ) override; + void SelectionChanged(uint32_t oldStart, uint32_t oldEnd, uint32_t newStart, uint32_t newEnd) override; + /** + * @copydoc Text::EditableControlInterface::AddDecoration() + */ + void AddDecoration(Actor& actor, Toolkit::Text::DecorationType type, bool needsClipping) override; -// From SelectableControlInterface + /** + * @copydoc Text::EditableControlInterface::InputFiltered() + */ + void InputFiltered(Toolkit::InputFilter::Property::Type type) override; + + /** + * @copydoc Text::EditableControlInterface::GetControlBackgroundColor() + */ + void GetControlBackgroundColor(Vector4& color) const override; + + // From SelectableControlInterface public: + /** * @copydoc Text::SelectableControlInterface::SetTextSelectionRange() */ - void SetTextSelectionRange(const uint32_t *start, const uint32_t *end) override; + void SetTextSelectionRange(const uint32_t* start, const uint32_t* end) override; /** * @copydoc Text::SelectableControlInterface::GetTextSelectionRange() */ Uint32Pair GetTextSelectionRange() const override; -private: // Implementation + /** + * @copydoc Text::SelectableControlInterface::SelectWholeText() + */ + void SelectWholeText() override; + + /** + * @copydoc Text::SelectableControlInterface::SelectNone() + */ + void SelectNone() override; + + /** + * @copydoc Text::SelectableControlInterface::SelectText() + */ + void SelectText(const uint32_t start, const uint32_t end) override; /** + * @copydoc Text::SelectableControlInterface::GetSelectedText() + */ + string GetSelectedText() const override; + + /** + * @copydoc Text::EditableControlInterface::IsEditable() + */ + bool IsEditable() const override; + + /** + * @copydoc Text::EditableControlInterface::SetEditable() + */ + void SetEditable(bool editable) override; + + /** + * @copydoc Dali::EditableControlInterface::CopyText() + */ + string CopyText() override; + + /** + * @copydoc Dali::EditableControlInterface::CutText() + */ + string CutText() override; + + /** + * @copydoc Text::EditableControlInterface::PasteText() + */ + void PasteText() override; + + // From AnchorControlInterface + + /** + * @copydoc Text::AnchorControlInterface::AnchorClicked() + */ + void AnchorClicked(const std::string& href) override; + + /** + * @brief Get the rendered size of a specific text range. + * if the requested text is at multilines, multiple sizes will be returned for each text located in a separate line. + * if a line contains characters with different directions, multiple sizes will be returned for each block of contiguous characters with the same direction. + * + * @param[in] startIndex start index of the text requested to calculate size for. + * @param[in] endIndex end index(included) of the text requested to calculate size for. + * @return list of sizes of the reuested text. + */ + Vector GetTextSize(const uint32_t startIndex, const uint32_t endIndex) const; + + /** + * @brief Get the top/left rendered position of a specific text range. + * if the requested text is at multilines, multiple positions will be returned for each text located in a separate line. + * if a line contains characters with different directions, multiple positions will be returned for each block of contiguous characters with the same direction. + * + * @param[in] startIndex start index of the text requested to get position to. + * @param[in] endIndex end index(included) of the text requested to get position to. + * @return list of positions of the requested text. + */ + Vector GetTextPosition(const uint32_t startIndex, const uint32_t endIndex) const; + +private: // Implementation + /** * @copydoc Dali::Toolkit::Text::Controller::(InputMethodContext& inputMethodContext, const InputMethodContext::EventData& inputMethodContextEvent) */ - InputMethodContext::CallbackData OnInputMethodContextEvent( InputMethodContext& inputMethodContext, const InputMethodContext::EventData& inputMethodContextEvent ); + InputMethodContext::CallbackData OnInputMethodContextEvent(InputMethodContext& inputMethodContext, const InputMethodContext::EventData& inputMethodContextEvent); /** * @brief Callback when Clipboard signals an item should be pasted * @param[in] clipboard handle to Clipboard Event Notifier */ - void OnClipboardTextSelected( ClipboardEventNotifier& clipboard ); + void OnClipboardTextSelected(ClipboardEventNotifier& clipboard); /** * @brief Get a Property Map for the image used for the required Handle Image @@ -236,7 +375,7 @@ private: // Implementation * @param[in] handleType the type of handle * @param[in] handleImageType the type of image for the given handleType */ - void GetHandleImagePropertyValue( Property::Value& value, Text::HandleType handleType, Text::HandleImageType handleImageType ); + void GetHandleImagePropertyValue(Property::Value& value, Text::HandleType handleType, Text::HandleImageType handleImageType); /** * @brief Enable or disable clipping. @@ -248,7 +387,7 @@ private: // Implementation * * @param[in] keyboardShown True if keyboard is shown. */ - void KeyboardStatusChanged( bool keyboardShown ); + void KeyboardStatusChanged(bool keyboardShown); /** * @brief Callback when TextField is touched @@ -256,7 +395,7 @@ private: // Implementation * @param[in] actor TextField touched * @param[in] touch Touch information */ - bool OnTouched( Actor actor, const TouchEvent& touch ); + bool OnTouched(Actor actor, const TouchEvent& touch); /** * @brief Callbacks called on idle. @@ -266,6 +405,45 @@ private: // Implementation void OnIdleSignal(); /** + * @brief Emits TextChanged signal. + */ + void EmitTextChangedSignal(); + + /** + * @brief Emits CursorPositionChanged signal. + */ + void EmitCursorPositionChangedSignal(); + + /** + * @brief Emits SelectionChanged signal. + */ + void EmitSelectionChangedSignal(); + + /** + * @brief Emits SelectionCleared signal. + */ + void EmitSelectionClearedSignal(); + + /** + * @brief Emits SelectionStarted signal. + */ + void EmitSelectionStartedSignal(); + + /** + * @brief Callback function for when the layout is changed. + * @param[in] actor The actor whose layoutDirection is changed. + * @param[in] type The layoutDirection. + */ + void OnLayoutDirectionChanged(Actor actor, LayoutDirection::Type type); + + /** + * @brief Add a layer for active or cursor. + * @param[in] layer The actor in which to store the layer. + * @param[in] actor The new layer to add. + */ + void AddLayer(Actor& layer, Actor& actor); + + /** * Construct a new TextField. */ TextField(); @@ -280,48 +458,118 @@ private: // Implementation TextField& operator=(const TextField& rhs); /** + * @brief Resize actor to the given size. + * + * @param[in] actor The actor to be resized. + * @param[in] size Size to change. + */ + void ResizeActor(Actor& actor, const Vector2& size); + + /** * @brief Render view, create and attach actor(s) to this Text Field. */ - void RenderText( Text::Controller::UpdateTextType updateTextType ); + void RenderText(Text::Controller::UpdateTextType updateTextType); // Connection needed to re-render text, when a Text Field returns to the scene. - void OnSceneConnect( Dali::Actor actor ); - -public: // For UTC only + void OnSceneConnect(Dali::Actor actor); - Text::ControllerPtr GetTextController() { return mController; } + // Needed to synchronize TextAnchor actors with Anchor objects in text's logical model + void OnAccessibilityStatusChanged(); private: // Data - // Signals - Toolkit::TextField::TextChangedSignalType mTextChangedSignal; - Toolkit::TextField::MaxLengthReachedSignalType mMaxLengthReachedSignal; - Toolkit::TextField::InputStyleChangedSignalType mInputStyleChangedSignal; - - InputMethodContext mInputMethodContext; - Text::ControllerPtr mController; - Text::RendererPtr mRenderer; - Text::DecoratorPtr mDecorator; - Toolkit::Control mStencil; ///< For EXCEED_POLICY_CLIP - std::vector mClippingDecorationActors; ///< Decoration actors which need clipping. - Dali::InputMethodOptions mInputMethodOptions; - - Actor mRenderableActor; - Actor mActiveLayer; - Actor mBackgroundActor; + Toolkit::TextField::TextChangedSignalType mTextChangedSignal; + Toolkit::TextField::MaxLengthReachedSignalType mMaxLengthReachedSignal; + Toolkit::TextField::InputStyleChangedSignalType mInputStyleChangedSignal; + Toolkit::DevelTextField::AnchorClickedSignalType mAnchorClickedSignal; + Toolkit::DevelTextField::InputFilteredSignalType mInputFilteredSignal; + Toolkit::DevelTextField::CursorPositionChangedSignalType mCursorPositionChangedSignal; + Toolkit::DevelTextField::SelectionChangedSignalType mSelectionChangedSignal; + Toolkit::DevelTextField::SelectionClearedSignalType mSelectionClearedSignal; + Toolkit::DevelTextField::SelectionStartedSignalType mSelectionStartedSignal; + + InputMethodContext mInputMethodContext; + Text::ControllerPtr mController; + Text::RendererPtr mRenderer; + Text::DecoratorPtr mDecorator; + Toolkit::Control mStencil; ///< For EXCEED_POLICY_CLIP + std::vector mClippingDecorationActors; ///< Decoration actors which need clipping. + std::vector mAnchorActors; + Dali::InputMethodOptions mInputMethodOptions; + + Actor mRenderableActor; + Actor mActiveLayer; + Actor mCursorLayer; + Actor mBackgroundActor; CallbackBase* mIdleCallback; float mAlignmentOffset; - int mRenderingBackend; - int mExceedPolicy; - bool mHasBeenStaged:1; + int mRenderingBackend; + int mExceedPolicy; + bool mHasBeenStaged : 1; + bool mTextChanged : 1; ///< If true, emits TextChangedSignal in next OnRelayout(). + bool mCursorPositionChanged : 1; ///< If true, emits CursorPositionChangedSignal at the end of OnRelayout(). + bool mSelectionChanged : 1; ///< If true, emits SelectionChangedSignal at the end of OnRelayout(). + bool mSelectionCleared : 1; ///< If true, emits SelectionClearedSignal at the end of OnRelayout(). + + //args for cursor position changed event + unsigned int mOldPosition; + + //args for selection changed event + uint32_t mOldSelectionStart; + uint32_t mOldSelectionEnd; + + bool mSelectionStarted : 1; ///< If true, emits SelectionStartedSignal at the end of OnRelayout(). + +protected: + struct PropertyHandler; + + /** + * @brief This structure is to connect TextField with Accessible functions. + */ + class TextFieldAccessible : public EditableTextControlAccessible + { + public: + using EditableTextControlAccessible::EditableTextControlAccessible; + + /** + * @copydoc Dali::Accessibility::Accessible::GetName() + */ + std::string GetName() const override; + + protected: + /** + * @copydoc Dali::Toolkit::Internal::TextControlAccessible::GetTextAnchors() + */ + const std::vector& GetTextAnchors() const override; + + /** + * @copydoc Dali::Toolkit::Internal::TextControlAccessible::GetTextController() + */ + Toolkit::Text::ControllerPtr GetTextController() const override; + + /** + * @copydoc Dali::Toolkit::Internal::TextControlAccessible::GetSubstituteCharacter() + */ + std::uint32_t GetSubstituteCharacter() const override; + + /** + * @copydoc Dali::Toolkit::Internal::TextControlAccessible::IsHiddenInput() + */ + bool IsHiddenInput() const override; + + /** + * @copydoc Dali::Toolkit::Internal::EditableTextControlAccessible::RequestTextRelayout() + */ + void RequestTextRelayout() override; + }; }; } // namespace Internal // Helpers for public-api forwarding methods -inline Toolkit::Internal::TextField& GetImpl( Toolkit::TextField& textField ) +inline Toolkit::Internal::TextField& GetImpl(Toolkit::TextField& textField) { DALI_ASSERT_ALWAYS(textField); @@ -330,7 +578,7 @@ inline Toolkit::Internal::TextField& GetImpl( Toolkit::TextField& textField ) return static_cast(handle); } -inline const Toolkit::Internal::TextField& GetImpl( const Toolkit::TextField& textField ) +inline const Toolkit::Internal::TextField& GetImpl(const Toolkit::TextField& textField) { DALI_ASSERT_ALWAYS(textField);