1 #ifndef DALI_TOOLKIT_INTERNAL_TEXT_CONTROLS_COMMON_TEXT_UTILS_H
2 #define DALI_TOOLKIT_INTERNAL_TEXT_CONTROLS_COMMON_TEXT_UTILS_H
5 * Copyright (c) 2021 Samsung Electronics Co., Ltd.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
21 #include <dali/devel-api/atspi-interfaces/editable-text.h>
22 #include <dali/devel-api/atspi-interfaces/hypertext.h>
23 #include <dali/devel-api/atspi-interfaces/text.h>
24 #include <dali/public-api/actors/actor.h>
25 #include <dali/public-api/common/vector-wrapper.h>
28 #include <dali-toolkit/devel-api/controls/control-accessible.h>
29 #include <dali-toolkit/devel-api/controls/text-controls/text-anchor-devel.h>
30 #include <dali-toolkit/internal/text/decorator/text-decorator.h>
31 #include <dali-toolkit/internal/text/rendering/text-renderer.h>
32 #include <dali-toolkit/internal/text/text-controller.h>
33 #include <dali-toolkit/public-api/controls/control.h>
34 #include <dali-toolkit/public-api/controls/text-controls/text-editor.h>
36 namespace Dali::Toolkit::Internal
42 * Common method to render text, setting up background, foreground actors with decorators/stencil.
43 * @param[in] textActor The TextEditor or TextField
44 * @param[in] renderer pointer to the text renderer
45 * @param[in] controller pointer to the text controller
46 * @param[in] decorator pointer to the text decorator
47 * @param[in,out] alignmentOffset Alignment offset
48 * @param[in,out] renderableActor Actor for rendering text
49 * @param[in,out] backgroundActor Actor for rendering background
50 * @param[in,out] stencil Clipping actor
51 * @param[in,out] clippingDecorationActors Clipping decoration actors
52 * @param[in,out] anchorActors Anchor actors
53 * @param[in] updateTextType How the text has been updated
55 static void RenderText(
57 Text::RendererPtr renderer,
58 Text::ControllerPtr controller,
59 Text::DecoratorPtr decorator,
60 float& alignmentOffset,
61 Actor& renderableActor,
62 Actor& backgroundActor,
63 Toolkit::Control& stencil,
64 std::vector<Actor>& clippingDecorationActors,
65 std::vector<Toolkit::TextAnchor>& anchorActors,
66 Text::Controller::UpdateTextType updateTextType);
69 * Common method to synchronize TextAnchor actors with Anchor objects in text's logical model.
70 * @param[in] parent The actor that is a parent of anchor actors
71 * @param[in] controller pointer to the text controller
72 * @param[in,out] anchorActors Anchor actors
74 static void SynchronizeTextAnchorsInParent(
76 Text::ControllerPtr controller,
77 std::vector<Toolkit::TextAnchor>& anchorActors);
80 class TextControlAccessible : public DevelControl::ControlAccessible,
81 public virtual Dali::Accessibility::Text,
82 public virtual Dali::Accessibility::Hypertext
85 using DevelControl::ControlAccessible::ControlAccessible;
90 * @copydoc Dali::Accessibility::Text::GetCharacterCount()
92 std::size_t GetCharacterCount() const override;
95 * @copydoc Dali::Accessibility::Text::GetCursorOffset()
97 std::size_t GetCursorOffset() const override;
100 * @copydoc Dali::Accessibility::Text::GetRangeExtents()
102 Rect<> GetRangeExtents(std::size_t startOffset, std::size_t endOffset, Accessibility::CoordinateType type) override;
105 * @copydoc Dali::Accessibility::Text::GetRangeOfSelection()
107 Accessibility::Range GetRangeOfSelection(std::size_t selectionIndex) const override;
110 * @copydoc Dali::Accessibility::Text::GetText()
112 std::string GetText(std::size_t startOffset, std::size_t endOffset) const override;
115 * @copydoc Dali::Accessibility::Text::GetTextAtOffset()
117 Accessibility::Range GetTextAtOffset(std::size_t offset, Accessibility::TextBoundary boundary) const override;
120 * @copydoc Dali::Accessibility::Text::RemoveSelection()
122 bool RemoveSelection(std::size_t selectionIndex) override;
125 * @copydoc Dali::Accessibility::Text::SetCursorOffset()
127 bool SetCursorOffset(std::size_t offset) override;
130 * @copydoc Dali::Accessibility::Text::SetRangeOfSelection()
132 bool SetRangeOfSelection(std::size_t selectionIndex, std::size_t startOffset, std::size_t endOffset) override;
137 * @copydoc Dali::Accessibility::Hypertext::GetLink()
139 Accessibility::Hyperlink* GetLink(std::int32_t linkIndex) const override;
142 * @copydoc Dali::Accessibility::Hypertext::GetLinkCount()
144 std::int32_t GetLinkCount() const override;
147 * @copydoc Dali::Accessibility::Hypertext::GetLinkIndex()
149 std::int32_t GetLinkIndex(std::int32_t characterOffset) const override;
153 * @brief Gets whole text.
157 std::string GetWholeText() const;
160 * @brief Gets text anchors.
162 * @return Text anchors
164 virtual const std::vector<Toolkit::TextAnchor>& GetTextAnchors() const = 0;
167 * @brief Gets text controller.
169 * @return The text controller
171 virtual Toolkit::Text::ControllerPtr GetTextController() const = 0;
174 * @brief Get substitute character for hidden text.
176 * @return The substitute character (Unicode codepoint)
178 virtual std::uint32_t GetSubstituteCharacter() const;
181 * @brief Checks whether text should be hidden (replaced with substitute characters).
183 * @return True if text should be hidden, false otherwise
185 virtual bool IsHiddenInput() const;
188 * @brief Checks whether [startPosition, endPosition) is a valid, non-empty range within a given string.
190 * @param string Source string
191 * @param begin Start index (inclusive)
192 * @param end End index (exclusive)
193 * @return true if the range is valid, false otherwise
195 static bool ValidateRange(const std::string& string, std::size_t begin, std::size_t end);
198 class EditableTextControlAccessible : public TextControlAccessible,
199 public virtual Dali::Accessibility::EditableText
202 using TextControlAccessible::TextControlAccessible;
205 * @copydoc Dali::Toolkit::DevelControl::ControlAccessible::CalculateStates()
207 Accessibility::States CalculateStates() override;
212 * @copydoc Dali::Accessibility::Text::GetCursorOffset()
214 std::size_t GetCursorOffset() const override;
217 * @copydoc Dali::Accessibility::Text::SetCursorOffset()
219 bool SetCursorOffset(std::size_t offset) override;
224 * @copydoc Dali::Accessibility::EditableText::CopyText()
226 bool CopyText(size_t startPosition, size_t endPosition) override;
229 * @copydoc Dali::Accessibility::EditableText::CutText()
231 bool CutText(size_t startPosition, size_t endPosition) override;
234 * @copydoc Dali::Accessibility::EditableText::DeleteText()
236 bool DeleteText(size_t startPosition, size_t endPosition) override;
239 * @copydoc Dali::Accessibility::EditableText::InsertText()
241 bool InsertText(size_t startPosition, std::string text) override;
244 * @copydoc Dali::Accessibility::EditableText::SetTextContents()
246 bool SetTextContents(std::string newContents) override;
250 * @brief Requests text relayout.
252 virtual void RequestTextRelayout() = 0;
255 } // namespace Dali::Toolkit::Internal
257 #endif //DALI_TOOLKIT_INTERNAL_TEXT_CONTROLS_COMMON_TEXT_UTILS_H