2 * Copyright (c) 2021 Samsung Electronics Co., Ltd.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
19 #include <dali-toolkit/internal/text/text-controller.h>
22 #include <dali-toolkit/devel-api/controls/control-depth-index-ranges.h>
23 #include <dali/devel-api/adaptor-framework/window-devel.h>
24 #include <dali/integration-api/debug.h>
30 #include <dali-toolkit/devel-api/text/text-enumerations-devel.h>
31 #include <dali-toolkit/internal/text/text-controller-event-handler.h>
32 #include <dali-toolkit/internal/text/text-controller-impl.h>
33 #include <dali-toolkit/internal/text/text-controller-input-font-handler.h>
34 #include <dali-toolkit/internal/text/text-controller-input-properties.h>
35 #include <dali-toolkit/internal/text/text-controller-placeholder-handler.h>
36 #include <dali-toolkit/internal/text/text-controller-relayouter.h>
37 #include <dali-toolkit/internal/text/text-controller-text-updater.h>
38 #include <dali-toolkit/internal/text/text-editable-control-interface.h>
42 #if defined(DEBUG_ENABLED)
43 Debug::Filter* gLogFilter = Debug::Filter::New(Debug::NoLogging, true, "LOG_TEXT_CONTROLS");
46 constexpr float MAX_FLOAT = std::numeric_limits<float>::max();
48 const std::string EMPTY_STRING("");
50 template<typename Type>
51 void EnsureCreated(Type*& object)
59 template<typename Type>
60 void EnsureCreated(std::unique_ptr<Type>& object)
64 object = std::unique_ptr<Type>(new Type());
68 template<typename Type, typename Arg1>
69 void EnsureCreated(Type*& object, Arg1 arg1)
73 object = new Type(arg1);
77 template<typename Type, typename Arg1, typename Arg2>
78 void EnsureCreated(Type*& object, Arg1 arg1, Arg2 arg2)
82 object = new Type(arg1, arg2);
88 unsigned int horizontalDpi = 0u;
89 unsigned int verticalDpi = 0u;
90 Dali::TextAbstraction::FontClient fontClient = Dali::TextAbstraction::FontClient::Get();
91 fontClient.GetDpi(horizontalDpi, verticalDpi);
92 return static_cast<float>(horizontalDpi);
95 float ConvertPixelToPoint(float pixel)
97 return pixel * 72.0f / GetDpi();
100 float ConvertPointToPixel(float point)
102 // Pixel size = Point size * DPI / 72.f
103 return point * GetDpi() / 72.0f;
106 void UpdateCursorPosition(Dali::Toolkit::Text::EventData* eventData)
108 if(eventData && Dali::Toolkit::Text::EventData::IsEditingState(eventData->mState))
110 // Update the cursor position if it's in editing mode
111 eventData->mDecoratorUpdated = true;
112 eventData->mUpdateCursorPosition = true; // Cursor position should be updated when the font size is updated.
118 namespace Dali::Toolkit::Text
121 void Controller::EnableTextInput(DecoratorPtr decorator, InputMethodContext& inputMethodContext)
125 delete mImpl->mEventData;
126 mImpl->mEventData = NULL;
128 // Nothing else to do.
132 EnsureCreated(mImpl->mEventData, decorator, inputMethodContext);
135 void Controller::SetGlyphType(TextAbstraction::GlyphType glyphType)
137 // Metrics for bitmap & vector based glyphs are different
138 mImpl->mMetrics->SetGlyphType(glyphType);
140 // Clear the font-specific data
141 mImpl->ClearFontData();
143 mImpl->RequestRelayout();
146 void Controller::SetMarkupProcessorEnabled(bool enable)
148 if(enable != mImpl->mMarkupProcessorEnabled)
150 //If Text was already set, call the SetText again for enabling or disabling markup
151 mImpl->mMarkupProcessorEnabled = enable;
157 mImpl->mModel->mVisualModel->SetMarkupProcessorEnabled(enable);
160 bool Controller::IsMarkupProcessorEnabled() const
162 return mImpl->mMarkupProcessorEnabled;
165 bool Controller::HasAnchors() const
167 return (mImpl->mMarkupProcessorEnabled && mImpl->mModel->mLogicalModel->mAnchors.Count() && mImpl->IsShowingRealText());
170 void Controller::SetAutoScrollEnabled(bool enable)
172 DALI_LOG_INFO(gLogFilter, Debug::General, "Controller::SetAutoScrollEnabled[%s] SingleBox[%s]-> [%p]\n", (enable) ? "true" : "false", (mImpl->mLayoutEngine.GetLayout() == Layout::Engine::SINGLE_LINE_BOX) ? "true" : "false", this);
173 mImpl->SetAutoScrollEnabled(enable);
176 bool Controller::IsAutoScrollEnabled() const
178 DALI_LOG_INFO(gLogFilter, Debug::Verbose, "Controller::IsAutoScrollEnabled[%s]\n", mImpl->mIsAutoScrollEnabled ? "true" : "false");
179 return mImpl->mIsAutoScrollEnabled;
182 CharacterDirection Controller::GetAutoScrollDirection() const
184 return mImpl->mIsTextDirectionRTL;
187 float Controller::GetAutoScrollLineAlignment() const
190 if(mImpl->mModel->mVisualModel && (0u != mImpl->mModel->mVisualModel->mLines.Count()))
192 offset = (*mImpl->mModel->mVisualModel->mLines.Begin()).alignmentOffset;
197 void Controller::SetHorizontalScrollEnabled(bool enable)
199 if(mImpl->mEventData && mImpl->mEventData->mDecorator)
201 mImpl->mEventData->mDecorator->SetHorizontalScrollEnabled(enable);
205 bool Controller::IsHorizontalScrollEnabled() const
207 return mImpl->mEventData && mImpl->mEventData->mDecorator && mImpl->mEventData->mDecorator->IsHorizontalScrollEnabled();
210 void Controller::SetVerticalScrollEnabled(bool enable)
212 if(mImpl->mEventData && mImpl->mEventData->mDecorator)
214 mImpl->mEventData->mDecorator->SetVerticalScrollEnabled(enable);
218 bool Controller::IsVerticalScrollEnabled() const
220 return mImpl->mEventData && mImpl->mEventData->mDecorator && mImpl->mEventData->mDecorator->IsVerticalScrollEnabled();
223 void Controller::SetSmoothHandlePanEnabled(bool enable)
225 if(mImpl->mEventData && mImpl->mEventData->mDecorator)
227 mImpl->mEventData->mDecorator->SetSmoothHandlePanEnabled(enable);
231 bool Controller::IsSmoothHandlePanEnabled() const
233 return mImpl->mEventData && mImpl->mEventData->mDecorator && mImpl->mEventData->mDecorator->IsSmoothHandlePanEnabled();
236 void Controller::SetMaximumNumberOfCharacters(Length maxCharacters)
238 mImpl->mMaximumNumberOfCharacters = maxCharacters;
241 int Controller::GetMaximumNumberOfCharacters()
243 return mImpl->mMaximumNumberOfCharacters;
246 void Controller::SetEnableCursorBlink(bool enable)
248 mImpl->SetEnableCursorBlink(enable);
251 bool Controller::GetEnableCursorBlink() const
253 return mImpl->mEventData && mImpl->mEventData->mCursorBlinkEnabled;
256 void Controller::SetMultiLineEnabled(bool enable)
258 mImpl->SetMultiLineEnabled(enable);
261 bool Controller::IsMultiLineEnabled() const
263 return Layout::Engine::MULTI_LINE_BOX == mImpl->mLayoutEngine.GetLayout();
266 void Controller::SetHorizontalAlignment(Text::HorizontalAlignment::Type alignment)
268 mImpl->SetHorizontalAlignment(alignment);
271 Text::HorizontalAlignment::Type Controller::GetHorizontalAlignment() const
273 return mImpl->mModel->mHorizontalAlignment;
276 void Controller::SetVerticalAlignment(VerticalAlignment::Type alignment)
278 mImpl->SetVerticalAlignment(alignment);
281 VerticalAlignment::Type Controller::GetVerticalAlignment() const
283 return mImpl->mModel->mVerticalAlignment;
286 bool Controller::IsIgnoreSpacesAfterText() const
288 return mImpl->mModel->mIgnoreSpacesAfterText;
291 void Controller::SetIgnoreSpacesAfterText(bool ignore)
293 mImpl->mModel->mIgnoreSpacesAfterText = ignore;
296 void Controller::ChangedLayoutDirection()
298 mImpl->mIsLayoutDirectionChanged = true;
301 void Controller::SetMatchLayoutDirection(DevelText::MatchLayoutDirection type)
303 mImpl->mModel->mMatchLayoutDirection = type;
306 DevelText::MatchLayoutDirection Controller::GetMatchLayoutDirection() const
308 return mImpl->mModel->mMatchLayoutDirection;
311 void Controller::SetLayoutDirection(Dali::LayoutDirection::Type layoutDirection)
313 mImpl->mLayoutDirection = layoutDirection;
316 Dali::LayoutDirection::Type Controller::GetLayoutDirection(Dali::Actor& actor) const
318 if(mImpl->mModel->mMatchLayoutDirection == DevelText::MatchLayoutDirection::LOCALE ||
319 (mImpl->mModel->mMatchLayoutDirection == DevelText::MatchLayoutDirection::INHERIT && !mImpl->mIsLayoutDirectionChanged))
321 return static_cast<Dali::LayoutDirection::Type>(DevelWindow::Get(actor).GetRootLayer().GetProperty(Dali::Actor::Property::LAYOUT_DIRECTION).Get<int>());
325 return static_cast<Dali::LayoutDirection::Type>(actor.GetProperty(Dali::Actor::Property::LAYOUT_DIRECTION).Get<int>());
329 bool Controller::IsShowingRealText() const
331 return mImpl->IsShowingRealText();
334 void Controller::SetLineWrapMode(Text::LineWrap::Mode lineWrapMode)
336 mImpl->SetLineWrapMode(lineWrapMode);
339 Text::LineWrap::Mode Controller::GetLineWrapMode() const
341 return mImpl->mModel->mLineWrapMode;
344 void Controller::SetTextElideEnabled(bool enabled)
346 mImpl->mModel->mElideEnabled = enabled;
347 mImpl->mModel->mVisualModel->SetTextElideEnabled(enabled);
350 bool Controller::IsTextElideEnabled() const
352 return mImpl->mModel->mElideEnabled;
355 void Controller::SetTextFitEnabled(bool enabled)
357 mImpl->mTextFitEnabled = enabled;
360 bool Controller::IsTextFitEnabled() const
362 return mImpl->mTextFitEnabled;
365 void Controller::SetTextFitChanged(bool changed)
367 mImpl->mTextFitChanged = changed;
370 bool Controller::IsTextFitChanged() const
372 return mImpl->mTextFitChanged;
375 void Controller::SetTextFitMinSize(float minSize, FontSizeType type)
377 mImpl->mTextFitMinSize = (type == POINT_SIZE) ? minSize : ConvertPixelToPoint(minSize);
380 float Controller::GetTextFitMinSize() const
382 return mImpl->mTextFitMinSize;
385 void Controller::SetTextFitMaxSize(float maxSize, FontSizeType type)
387 mImpl->mTextFitMaxSize = (type == POINT_SIZE) ? maxSize : ConvertPixelToPoint(maxSize);
390 float Controller::GetTextFitMaxSize() const
392 return mImpl->mTextFitMaxSize;
395 void Controller::SetTextFitStepSize(float step, FontSizeType type)
397 mImpl->mTextFitStepSize = (type == POINT_SIZE) ? step : ConvertPixelToPoint(step);
400 float Controller::GetTextFitStepSize() const
402 return mImpl->mTextFitStepSize;
405 void Controller::SetTextFitContentSize(Vector2 size)
407 mImpl->mTextFitContentSize = size;
410 Vector2 Controller::GetTextFitContentSize() const
412 return mImpl->mTextFitContentSize;
415 float Controller::GetTextFitPointSize() const
417 return mImpl->mFontDefaults ? mImpl->mFontDefaults->mFitPointSize : 0.0f;
420 void Controller::SetPlaceholderTextElideEnabled(bool enabled)
422 PlaceholderHandler::SetPlaceholderTextElideEnabled(*this, enabled);
425 bool Controller::IsPlaceholderTextElideEnabled() const
427 return PlaceholderHandler::IsPlaceholderTextElideEnabled(*this);
430 void Controller::SetSelectionEnabled(bool enabled)
432 mImpl->mEventData->mSelectionEnabled = enabled;
435 bool Controller::IsSelectionEnabled() const
437 return mImpl->mEventData->mSelectionEnabled;
440 void Controller::SetShiftSelectionEnabled(bool enabled)
442 mImpl->mEventData->mShiftSelectionFlag = enabled;
445 bool Controller::IsShiftSelectionEnabled() const
447 return mImpl->mEventData->mShiftSelectionFlag;
450 void Controller::SetGrabHandleEnabled(bool enabled)
452 mImpl->mEventData->mGrabHandleEnabled = enabled;
455 bool Controller::IsGrabHandleEnabled() const
457 return mImpl->mEventData->mGrabHandleEnabled;
460 void Controller::SetGrabHandlePopupEnabled(bool enabled)
462 mImpl->mEventData->mGrabHandlePopupEnabled = enabled;
465 bool Controller::IsGrabHandlePopupEnabled() const
467 return mImpl->mEventData->mGrabHandlePopupEnabled;
470 void Controller::SetText(const std::string& text)
472 TextUpdater::SetText(*this, text);
475 void Controller::GetText(std::string& text) const
477 if(!mImpl->IsShowingPlaceholderText())
479 // Retrieves the text string.
480 mImpl->GetText(0u, text);
484 DALI_LOG_INFO(gLogFilter, Debug::Verbose, "Controller::GetText %p empty (but showing placeholder)\n", this);
488 void Controller::SetPlaceholderText(PlaceholderType type, const std::string& text)
490 PlaceholderHandler::SetPlaceholderText(*this, type, text);
493 void Controller::GetPlaceholderText(PlaceholderType type, std::string& text) const
495 PlaceholderHandler::GetPlaceholderText(*this, type, text);
498 void Controller::UpdateAfterFontChange(const std::string& newDefaultFont)
500 mImpl->UpdateAfterFontChange(newDefaultFont);
503 void Controller::RetrieveSelection(std::string& selectedText) const
505 mImpl->RetrieveSelection(selectedText, false);
508 void Controller::SetSelection(int start, int end)
510 mImpl->SetSelection(start, end);
513 std::pair<int, int> Controller::GetSelectionIndexes() const
515 return mImpl->GetSelectionIndexes();
518 void Controller::CopyStringToClipboard(const std::string& source)
520 mImpl->CopyStringToClipboard(source);
523 void Controller::SendSelectionToClipboard(bool deleteAfterSending)
525 mImpl->SendSelectionToClipboard(deleteAfterSending);
528 void Controller::SetDefaultFontFamily(const std::string& defaultFontFamily)
530 EnsureCreated(mImpl->mFontDefaults);
532 mImpl->mFontDefaults->mFontDescription.family = defaultFontFamily;
533 DALI_LOG_INFO(gLogFilter, Debug::General, "Controller::SetDefaultFontFamily %s\n", defaultFontFamily.c_str());
534 mImpl->mFontDefaults->familyDefined = !defaultFontFamily.empty();
536 // Update the cursor position if it's in editing mode
537 UpdateCursorPosition(mImpl->mEventData);
539 // Clear the font-specific data
540 mImpl->ClearFontData();
542 mImpl->RequestRelayout();
545 const std::string& Controller::GetDefaultFontFamily() const
547 return mImpl->mFontDefaults ? mImpl->mFontDefaults->mFontDescription.family : EMPTY_STRING;
550 void Controller::SetPlaceholderFontFamily(const std::string& placeholderTextFontFamily)
552 PlaceholderHandler::SetPlaceholderFontFamily(*this, placeholderTextFontFamily);
555 const std::string& Controller::GetPlaceholderFontFamily() const
557 return PlaceholderHandler::GetPlaceholderFontFamily(*this);
560 void Controller::SetDefaultFontWeight(FontWeight weight)
562 EnsureCreated(mImpl->mFontDefaults);
564 mImpl->mFontDefaults->mFontDescription.weight = weight;
565 mImpl->mFontDefaults->weightDefined = true;
567 // Update the cursor position if it's in editing mode
568 UpdateCursorPosition(mImpl->mEventData);
570 // Clear the font-specific data
571 mImpl->ClearFontData();
573 mImpl->RequestRelayout();
576 bool Controller::IsDefaultFontWeightDefined() const
578 return mImpl->mFontDefaults && mImpl->mFontDefaults->weightDefined;
581 FontWeight Controller::GetDefaultFontWeight() const
583 return mImpl->mFontDefaults ? mImpl->mFontDefaults->mFontDescription.weight : TextAbstraction::FontWeight::NORMAL;
586 void Controller::SetPlaceholderTextFontWeight(FontWeight weight)
588 PlaceholderHandler::SetPlaceholderTextFontWeight(*this, weight);
591 bool Controller::IsPlaceholderTextFontWeightDefined() const
593 return PlaceholderHandler::IsPlaceholderTextFontWeightDefined(*this);
596 FontWeight Controller::GetPlaceholderTextFontWeight() const
598 return PlaceholderHandler::GetPlaceholderTextFontWeight(*this);
601 void Controller::SetDefaultFontWidth(FontWidth width)
603 EnsureCreated(mImpl->mFontDefaults);
605 mImpl->mFontDefaults->mFontDescription.width = width;
606 mImpl->mFontDefaults->widthDefined = true;
608 // Update the cursor position if it's in editing mode
609 UpdateCursorPosition(mImpl->mEventData);
611 // Clear the font-specific data
612 mImpl->ClearFontData();
614 mImpl->RequestRelayout();
617 bool Controller::IsDefaultFontWidthDefined() const
619 return mImpl->mFontDefaults && mImpl->mFontDefaults->widthDefined;
622 FontWidth Controller::GetDefaultFontWidth() const
624 return mImpl->mFontDefaults ? mImpl->mFontDefaults->mFontDescription.width : TextAbstraction::FontWidth::NORMAL;
627 void Controller::SetPlaceholderTextFontWidth(FontWidth width)
629 PlaceholderHandler::SetPlaceholderTextFontWidth(*this, width);
632 bool Controller::IsPlaceholderTextFontWidthDefined() const
634 return PlaceholderHandler::IsPlaceholderTextFontWidthDefined(*this);
637 FontWidth Controller::GetPlaceholderTextFontWidth() const
639 return PlaceholderHandler::GetPlaceholderTextFontWidth(*this);
642 void Controller::SetDefaultFontSlant(FontSlant slant)
644 EnsureCreated(mImpl->mFontDefaults);
646 mImpl->mFontDefaults->mFontDescription.slant = slant;
647 mImpl->mFontDefaults->slantDefined = true;
649 // Update the cursor position if it's in editing mode
650 UpdateCursorPosition(mImpl->mEventData);
652 // Clear the font-specific data
653 mImpl->ClearFontData();
655 mImpl->RequestRelayout();
658 bool Controller::IsDefaultFontSlantDefined() const
660 return mImpl->mFontDefaults && mImpl->mFontDefaults->slantDefined;
663 FontSlant Controller::GetDefaultFontSlant() const
665 return mImpl->mFontDefaults ? mImpl->mFontDefaults->mFontDescription.slant : TextAbstraction::FontSlant::NORMAL;
668 void Controller::SetPlaceholderTextFontSlant(FontSlant slant)
670 PlaceholderHandler::SetPlaceholderTextFontSlant(*this, slant);
673 bool Controller::IsPlaceholderTextFontSlantDefined() const
675 return PlaceholderHandler::IsPlaceholderTextFontSlantDefined(*this);
678 FontSlant Controller::GetPlaceholderTextFontSlant() const
680 return PlaceholderHandler::GetPlaceholderTextFontSlant(*this);
683 void Controller::SetFontSizeScale(float scale)
685 mImpl->mFontSizeScale = scale;
687 // Update the cursor position if it's in editing mode
688 UpdateCursorPosition(mImpl->mEventData);
690 // Clear the font-specific data
691 mImpl->ClearFontData();
693 mImpl->RequestRelayout();
696 float Controller::GetFontSizeScale() const
698 return mImpl->mFontDefaults ? mImpl->mFontSizeScale : 1.0f;
701 void Controller::SetDefaultFontSize(float fontSize, FontSizeType type)
703 EnsureCreated(mImpl->mFontDefaults);
705 mImpl->mFontDefaults->mDefaultPointSize = (type == POINT_SIZE) ? fontSize : ConvertPixelToPoint(fontSize);
706 mImpl->mFontDefaults->sizeDefined = true;
708 // Update the cursor position if it's in editing mode
709 UpdateCursorPosition(mImpl->mEventData);
711 // Clear the font-specific data
712 mImpl->ClearFontData();
714 mImpl->RequestRelayout();
717 float Controller::GetDefaultFontSize(FontSizeType type) const
719 if(mImpl->mFontDefaults)
721 return (type == POINT_SIZE) ? mImpl->mFontDefaults->mDefaultPointSize : ConvertPointToPixel(mImpl->mFontDefaults->mDefaultPointSize);
726 void Controller::SetPlaceholderTextFontSize(float fontSize, FontSizeType type)
728 PlaceholderHandler::SetPlaceholderTextFontSize(*this, fontSize, type);
731 float Controller::GetPlaceholderTextFontSize(FontSizeType type) const
733 return PlaceholderHandler::GetPlaceholderTextFontSize(*this, type);
736 void Controller::SetDefaultColor(const Vector4& color)
738 mImpl->SetDefaultColor(color);
741 const Vector4& Controller::GetDefaultColor() const
743 return mImpl->mTextColor;
746 void Controller::SetPlaceholderTextColor(const Vector4& textColor)
748 PlaceholderHandler::SetPlaceholderTextColor(*this, textColor);
751 const Vector4& Controller::GetPlaceholderTextColor() const
753 return PlaceholderHandler::GetPlaceholderTextColor(*this);
756 void Controller::SetShadowOffset(const Vector2& shadowOffset)
758 mImpl->mModel->mVisualModel->SetShadowOffset(shadowOffset);
759 mImpl->RequestRelayout();
762 const Vector2& Controller::GetShadowOffset() const
764 return mImpl->mModel->mVisualModel->GetShadowOffset();
767 void Controller::SetShadowColor(const Vector4& shadowColor)
769 mImpl->mModel->mVisualModel->SetShadowColor(shadowColor);
770 mImpl->RequestRelayout();
773 const Vector4& Controller::GetShadowColor() const
775 return mImpl->mModel->mVisualModel->GetShadowColor();
778 void Controller::SetShadowBlurRadius(const float& shadowBlurRadius)
780 if(fabsf(GetShadowBlurRadius() - shadowBlurRadius) > Math::MACHINE_EPSILON_1)
782 mImpl->mModel->mVisualModel->SetShadowBlurRadius(shadowBlurRadius);
783 mImpl->RequestRelayout();
787 const float& Controller::GetShadowBlurRadius() const
789 return mImpl->mModel->mVisualModel->GetShadowBlurRadius();
792 void Controller::SetUnderlineColor(const Vector4& color)
794 mImpl->mModel->mVisualModel->SetUnderlineColor(color);
795 mImpl->RequestRelayout();
798 const Vector4& Controller::GetUnderlineColor() const
800 return mImpl->mModel->mVisualModel->GetUnderlineColor();
803 void Controller::SetUnderlineEnabled(bool enabled)
805 mImpl->mModel->mVisualModel->SetUnderlineEnabled(enabled);
806 mImpl->RequestRelayout();
809 bool Controller::IsUnderlineEnabled() const
811 return mImpl->mModel->mVisualModel->IsUnderlineEnabled();
814 void Controller::SetUnderlineHeight(float height)
816 mImpl->mModel->mVisualModel->SetUnderlineHeight(height);
817 mImpl->RequestRelayout();
820 float Controller::GetUnderlineHeight() const
822 return mImpl->mModel->mVisualModel->GetUnderlineHeight();
825 void Controller::SetOutlineColor(const Vector4& color)
827 mImpl->mModel->mVisualModel->SetOutlineColor(color);
828 mImpl->RequestRelayout();
831 const Vector4& Controller::GetOutlineColor() const
833 return mImpl->mModel->mVisualModel->GetOutlineColor();
836 void Controller::SetOutlineWidth(uint16_t width)
838 mImpl->mModel->mVisualModel->SetOutlineWidth(width);
839 mImpl->RequestRelayout();
842 uint16_t Controller::GetOutlineWidth() const
844 return mImpl->mModel->mVisualModel->GetOutlineWidth();
847 void Controller::SetBackgroundColor(const Vector4& color)
849 mImpl->mModel->mVisualModel->SetBackgroundColor(color);
850 mImpl->RequestRelayout();
853 const Vector4& Controller::GetBackgroundColor() const
855 return mImpl->mModel->mVisualModel->GetBackgroundColor();
858 void Controller::SetBackgroundEnabled(bool enabled)
860 mImpl->mModel->mVisualModel->SetBackgroundEnabled(enabled);
861 mImpl->RequestRelayout();
864 bool Controller::IsBackgroundEnabled() const
866 return mImpl->mModel->mVisualModel->IsBackgroundEnabled();
869 void Controller::SetDefaultEmbossProperties(const std::string& embossProperties)
871 EnsureCreated(mImpl->mEmbossDefaults);
872 mImpl->mEmbossDefaults->properties = embossProperties;
875 const std::string& Controller::GetDefaultEmbossProperties() const
877 return mImpl->mEmbossDefaults ? mImpl->mEmbossDefaults->properties : EMPTY_STRING;
880 void Controller::SetDefaultOutlineProperties(const std::string& outlineProperties)
882 EnsureCreated(mImpl->mOutlineDefaults);
883 mImpl->mOutlineDefaults->properties = outlineProperties;
886 const std::string& Controller::GetDefaultOutlineProperties() const
888 return mImpl->mOutlineDefaults ? mImpl->mOutlineDefaults->properties : EMPTY_STRING;
891 bool Controller::SetDefaultLineSpacing(float lineSpacing)
893 return mImpl->SetDefaultLineSpacing(lineSpacing);
896 float Controller::GetDefaultLineSpacing() const
898 return mImpl->mLayoutEngine.GetDefaultLineSpacing();
901 bool Controller::SetDefaultLineSize(float lineSize)
903 return mImpl->SetDefaultLineSize(lineSize);
906 float Controller::GetDefaultLineSize() const
908 return mImpl->mLayoutEngine.GetDefaultLineSize();
911 void Controller::SetInputColor(const Vector4& color)
913 InputProperties::SetInputColor(*this, color);
916 const Vector4& Controller::GetInputColor() const
918 return InputProperties::GetInputColor(*this);
921 void Controller::SetInputFontFamily(const std::string& fontFamily)
923 InputFontHandler::SetInputFontFamily(*this, fontFamily);
926 const std::string& Controller::GetInputFontFamily() const
928 return InputFontHandler::GetInputFontFamily(*this);
931 void Controller::SetInputFontWeight(FontWeight weight)
933 InputFontHandler::SetInputFontWeight(*this, weight);
936 bool Controller::IsInputFontWeightDefined() const
938 return InputFontHandler::IsInputFontWeightDefined(*this);
941 FontWeight Controller::GetInputFontWeight() const
943 return InputFontHandler::GetInputFontWeight(*this);
946 void Controller::SetInputFontWidth(FontWidth width)
948 InputFontHandler::SetInputFontWidth(*this, width);
951 bool Controller::IsInputFontWidthDefined() const
953 return InputFontHandler::IsInputFontWidthDefined(*this);
956 FontWidth Controller::GetInputFontWidth() const
958 return InputFontHandler::GetInputFontWidth(*this);
961 void Controller::SetInputFontSlant(FontSlant slant)
963 InputFontHandler::SetInputFontSlant(*this, slant);
966 bool Controller::IsInputFontSlantDefined() const
968 return InputFontHandler::IsInputFontSlantDefined(*this);
971 FontSlant Controller::GetInputFontSlant() const
973 return InputFontHandler::GetInputFontSlant(*this);
976 void Controller::SetInputFontPointSize(float size)
978 InputFontHandler::SetInputFontPointSize(*this, size);
981 float Controller::GetInputFontPointSize() const
983 return InputFontHandler::GetInputFontPointSize(*this);
986 void Controller::SetInputLineSpacing(float lineSpacing)
988 InputProperties::SetInputLineSpacing(*this, lineSpacing);
991 float Controller::GetInputLineSpacing() const
993 return InputProperties::GetInputLineSpacing(*this);
996 void Controller::SetInputShadowProperties(const std::string& shadowProperties)
998 InputProperties::SetInputShadowProperties(*this, shadowProperties);
1001 const std::string& Controller::GetInputShadowProperties() const
1003 return InputProperties::GetInputShadowProperties(*this);
1006 void Controller::SetInputUnderlineProperties(const std::string& underlineProperties)
1008 InputProperties::SetInputUnderlineProperties(*this, underlineProperties);
1011 const std::string& Controller::GetInputUnderlineProperties() const
1013 return InputProperties::GetInputUnderlineProperties(*this);
1016 void Controller::SetInputEmbossProperties(const std::string& embossProperties)
1018 InputProperties::SetInputEmbossProperties(*this, embossProperties);
1021 const std::string& Controller::GetInputEmbossProperties() const
1023 return InputProperties::GetInputEmbossProperties(*this);
1026 void Controller::SetInputOutlineProperties(const std::string& outlineProperties)
1028 InputProperties::SetInputOutlineProperties(*this, outlineProperties);
1031 const std::string& Controller::GetInputOutlineProperties() const
1033 return InputProperties::GetInputOutlineProperties(*this);
1036 void Controller::SetInputModePassword(bool passwordInput)
1038 InputProperties::SetInputModePassword(*this, passwordInput);
1041 bool Controller::IsInputModePassword()
1043 return InputProperties::IsInputModePassword(*this);
1046 void Controller::SetNoTextDoubleTapAction(NoTextTap::Action action)
1048 if(mImpl->mEventData)
1050 mImpl->mEventData->mDoubleTapAction = action;
1054 Controller::NoTextTap::Action Controller::GetNoTextDoubleTapAction() const
1056 return mImpl->mEventData ? mImpl->mEventData->mDoubleTapAction : NoTextTap::NO_ACTION;
1059 void Controller::SetNoTextLongPressAction(NoTextTap::Action action)
1061 if(mImpl->mEventData)
1063 mImpl->mEventData->mLongPressAction = action;
1067 Controller::NoTextTap::Action Controller::GetNoTextLongPressAction() const
1069 return mImpl->mEventData ? mImpl->mEventData->mLongPressAction : NoTextTap::NO_ACTION;
1072 bool Controller::IsUnderlineSetByString()
1074 return mImpl->mUnderlineSetByString;
1077 void Controller::UnderlineSetByString(bool setByString)
1079 mImpl->mUnderlineSetByString = setByString;
1082 bool Controller::IsShadowSetByString()
1084 return mImpl->mShadowSetByString;
1087 void Controller::ShadowSetByString(bool setByString)
1089 mImpl->mShadowSetByString = setByString;
1092 bool Controller::IsOutlineSetByString()
1094 return mImpl->mOutlineSetByString;
1097 void Controller::OutlineSetByString(bool setByString)
1099 mImpl->mOutlineSetByString = setByString;
1102 bool Controller::IsFontStyleSetByString()
1104 return mImpl->mFontStyleSetByString;
1107 void Controller::FontStyleSetByString(bool setByString)
1109 mImpl->mFontStyleSetByString = setByString;
1112 Layout::Engine& Controller::GetLayoutEngine()
1114 return mImpl->mLayoutEngine;
1117 View& Controller::GetView()
1119 return mImpl->mView;
1122 Vector3 Controller::GetNaturalSize()
1124 return Relayouter::GetNaturalSize(*this);
1127 bool Controller::CheckForTextFit(float pointSize, Size& layoutSize)
1129 return Relayouter::CheckForTextFit(*this, pointSize, layoutSize);
1132 void Controller::FitPointSizeforLayout(Size layoutSize)
1134 Relayouter::FitPointSizeforLayout(*this, layoutSize);
1137 float Controller::GetHeightForWidth(float width)
1139 return Relayouter::GetHeightForWidth(*this, width);
1142 int Controller::GetLineCount(float width)
1144 GetHeightForWidth(width);
1145 return mImpl->mModel->GetNumberOfLines();
1148 const ModelInterface* const Controller::GetTextModel() const
1150 return mImpl->mModel.Get();
1153 float Controller::GetScrollAmountByUserInput()
1155 float scrollAmount = 0.0f;
1157 if(NULL != mImpl->mEventData && mImpl->mEventData->mCheckScrollAmount)
1159 scrollAmount = mImpl->mModel->mScrollPosition.y - mImpl->mModel->mScrollPositionLast.y;
1160 mImpl->mEventData->mCheckScrollAmount = false;
1162 return scrollAmount;
1165 bool Controller::GetTextScrollInfo(float& scrollPosition, float& controlHeight, float& layoutHeight)
1167 const Vector2& layout = mImpl->mModel->mVisualModel->GetLayoutSize();
1170 controlHeight = mImpl->mModel->mVisualModel->mControlSize.height;
1171 layoutHeight = layout.height;
1172 scrollPosition = mImpl->mModel->mScrollPosition.y;
1173 isScrolled = !Equals(mImpl->mModel->mScrollPosition.y, mImpl->mModel->mScrollPositionLast.y, Math::MACHINE_EPSILON_1);
1177 void Controller::SetHiddenInputOption(const Property::Map& options)
1179 EnsureCreated<HiddenText, Controller*>(mImpl->mHiddenInput, this);
1180 mImpl->mHiddenInput->SetProperties(options);
1183 void Controller::GetHiddenInputOption(Property::Map& options)
1185 if(mImpl->mHiddenInput)
1187 mImpl->mHiddenInput->GetProperties(options);
1191 void Controller::SetInputFilterOption(const Property::Map& options)
1193 EnsureCreated(mImpl->mInputFilter);
1194 mImpl->mInputFilter->SetProperties(options);
1197 void Controller::GetInputFilterOption(Property::Map& options)
1199 if(mImpl->mInputFilter)
1201 mImpl->mInputFilter->GetProperties(options);
1205 void Controller::SetPlaceholderProperty(const Property::Map& map)
1207 PlaceholderHandler::SetPlaceholderProperty(*this, map);
1210 void Controller::GetPlaceholderProperty(Property::Map& map)
1212 PlaceholderHandler::GetPlaceholderProperty(*this, map);
1215 Toolkit::DevelText::TextDirection::Type Controller::GetTextDirection()
1217 // Make sure the model is up-to-date before layouting
1218 ProcessModifyEvents();
1220 if(mImpl->mUpdateTextDirection)
1222 // Operations that can be done only once until the text changes.
1223 const OperationsMask onlyOnceOperations = static_cast<OperationsMask>(CONVERT_TO_UTF32 |
1231 // Set the update info to relayout the whole text.
1232 mImpl->mTextUpdateInfo.mParagraphCharacterIndex = 0u;
1233 mImpl->mTextUpdateInfo.mRequestedNumberOfCharacters = mImpl->mModel->mLogicalModel->mText.Count();
1235 // Make sure the model is up-to-date before layouting
1236 mImpl->UpdateModel(onlyOnceOperations);
1238 Vector3 naturalSize;
1239 DoRelayout(Size(MAX_FLOAT, MAX_FLOAT),
1240 static_cast<OperationsMask>(onlyOnceOperations |
1241 LAYOUT | REORDER | UPDATE_DIRECTION),
1242 naturalSize.GetVectorXY());
1244 // Do not do again the only once operations.
1245 mImpl->mOperationsPending = static_cast<OperationsMask>(mImpl->mOperationsPending & ~onlyOnceOperations);
1247 // Clear the update info. This info will be set the next time the text is updated.
1248 mImpl->mTextUpdateInfo.Clear();
1250 // FullRelayoutNeeded should be true because DoRelayout is MAX_FLOAT, MAX_FLOAT.
1251 mImpl->mTextUpdateInfo.mFullRelayoutNeeded = true;
1253 mImpl->mUpdateTextDirection = false;
1256 return mImpl->mIsTextDirectionRTL ? Toolkit::DevelText::TextDirection::RIGHT_TO_LEFT : Toolkit::DevelText::TextDirection::LEFT_TO_RIGHT;
1259 Toolkit::DevelText::VerticalLineAlignment::Type Controller::GetVerticalLineAlignment() const
1261 return mImpl->mModel->GetVerticalLineAlignment();
1264 void Controller::SetVerticalLineAlignment(Toolkit::DevelText::VerticalLineAlignment::Type alignment)
1266 mImpl->mModel->mVerticalLineAlignment = alignment;
1269 Toolkit::DevelText::EllipsisPosition::Type Controller::GetEllipsisPosition() const
1271 return mImpl->mModel->GetEllipsisPosition();
1274 void Controller::SetEllipsisPosition(Toolkit::DevelText::EllipsisPosition::Type ellipsisPosition)
1276 mImpl->mModel->mEllipsisPosition = ellipsisPosition;
1277 mImpl->mModel->mVisualModel->SetEllipsisPosition(ellipsisPosition);
1280 Controller::UpdateTextType Controller::Relayout(const Size& size, Dali::LayoutDirection::Type layoutDirection)
1282 return Relayouter::Relayout(*this, size, layoutDirection);
1285 void Controller::RequestRelayout()
1287 mImpl->RequestRelayout();
1290 bool Controller::IsInputStyleChangedSignalsQueueEmpty()
1292 return mImpl->IsInputStyleChangedSignalsQueueEmpty();
1295 void Controller::ProcessInputStyleChangedSignals()
1297 mImpl->ProcessInputStyleChangedSignals();
1300 void Controller::KeyboardFocusGainEvent()
1302 EventHandler::KeyboardFocusGainEvent(*this);
1305 void Controller::KeyboardFocusLostEvent()
1307 EventHandler::KeyboardFocusLostEvent(*this);
1310 bool Controller::KeyEvent(const Dali::KeyEvent& keyEvent)
1312 return EventHandler::KeyEvent(*this, keyEvent);
1315 void Controller::AnchorEvent(float x, float y)
1317 EventHandler::AnchorEvent(*this, x, y);
1320 void Controller::TapEvent(unsigned int tapCount, float x, float y)
1322 EventHandler::TapEvent(*this, tapCount, x, y);
1325 void Controller::PanEvent(GestureState state, const Vector2& displacement)
1327 EventHandler::PanEvent(*this, state, displacement);
1330 void Controller::LongPressEvent(GestureState state, float x, float y)
1332 EventHandler::LongPressEvent(*this, state, x, y);
1335 void Controller::SelectEvent(float x, float y, SelectionType selectType)
1337 EventHandler::SelectEvent(*this, x, y, selectType);
1340 void Controller::SelectEvent(const uint32_t start, const uint32_t end, SelectionType selectType)
1342 EventHandler::SelectEvent(*this, start, end, selectType);
1345 void Controller::SetTextSelectionRange(const uint32_t* start, const uint32_t* end)
1347 if(mImpl->mEventData)
1349 mImpl->mEventData->mCheckScrollAmount = true;
1350 mImpl->mEventData->mIsLeftHandleSelected = true;
1351 mImpl->mEventData->mIsRightHandleSelected = true;
1352 mImpl->SetTextSelectionRange(start, end);
1353 mImpl->RequestRelayout();
1354 KeyboardFocusGainEvent();
1358 Uint32Pair Controller::GetTextSelectionRange() const
1360 return mImpl->GetTextSelectionRange();
1363 CharacterIndex Controller::GetPrimaryCursorPosition() const
1365 return mImpl->GetPrimaryCursorPosition();
1368 bool Controller::SetPrimaryCursorPosition(CharacterIndex index, bool focused)
1370 if(mImpl->mEventData)
1372 mImpl->mEventData->mCheckScrollAmount = true;
1373 mImpl->mEventData->mIsLeftHandleSelected = true;
1374 mImpl->mEventData->mIsRightHandleSelected = true;
1375 mImpl->mEventData->mCheckScrollAmount = true;
1376 if(mImpl->SetPrimaryCursorPosition(index, focused) && focused)
1378 KeyboardFocusGainEvent();
1385 void Controller::SelectWholeText()
1387 SelectEvent(0.f, 0.f, SelectionType::ALL);
1390 void Controller::SelectNone()
1392 SelectEvent(0.f, 0.f, SelectionType::NONE);
1395 void Controller::SelectText(const uint32_t start, const uint32_t end)
1397 SelectEvent(start, end, SelectionType::RANGE);
1400 string Controller::GetSelectedText() const
1403 if(EventData::SELECTING == mImpl->mEventData->mState)
1405 mImpl->RetrieveSelection(text, false);
1410 string Controller::CopyText()
1413 mImpl->RetrieveSelection(text, false);
1414 mImpl->SendSelectionToClipboard(false); // Text not modified
1416 mImpl->mEventData->mUpdateCursorPosition = true;
1418 mImpl->RequestRelayout(); // Cursor, Handles, Selection Highlight, Popup
1423 string Controller::CutText()
1426 mImpl->RetrieveSelection(text, false);
1430 return EMPTY_STRING;
1433 mImpl->SendSelectionToClipboard(true); // Synchronous call to modify text
1434 mImpl->mOperationsPending = ALL_OPERATIONS;
1436 if((0u != mImpl->mModel->mLogicalModel->mText.Count()) ||
1437 !mImpl->IsPlaceholderAvailable())
1439 mImpl->QueueModifyEvent(ModifyEvent::TEXT_DELETED);
1443 ShowPlaceholderText();
1446 mImpl->mEventData->mUpdateCursorPosition = true;
1447 mImpl->mEventData->mScrollAfterDelete = true;
1449 mImpl->RequestRelayout();
1451 if(nullptr != mImpl->mEditableControlInterface)
1453 mImpl->mEditableControlInterface->TextChanged(true);
1458 void Controller::PasteText()
1460 mImpl->RequestGetTextFromClipboard(); // Request clipboard service to retrieve an item
1463 InputMethodContext::CallbackData Controller::OnInputMethodContextEvent(InputMethodContext& inputMethodContext, const InputMethodContext::EventData& inputMethodContextEvent)
1465 return EventHandler::OnInputMethodContextEvent(*this, inputMethodContext, inputMethodContextEvent);
1468 void Controller::PasteClipboardItemEvent()
1470 EventHandler::PasteClipboardItemEvent(*this);
1473 void Controller::GetTargetSize(Vector2& targetSize)
1475 targetSize = mImpl->mModel->mVisualModel->mControlSize;
1478 void Controller::AddDecoration(Actor& actor, bool needsClipping)
1480 if(mImpl->mEditableControlInterface)
1482 mImpl->mEditableControlInterface->AddDecoration(actor, needsClipping);
1486 bool Controller::IsEditable() const
1488 return mImpl->IsEditable();
1491 void Controller::SetEditable(bool editable)
1493 mImpl->SetEditable(editable);
1496 void Controller::ScrollBy(Vector2 scroll)
1498 mImpl->ScrollBy(scroll);
1501 float Controller::GetHorizontalScrollPosition()
1503 return mImpl->GetHorizontalScrollPosition();
1506 float Controller::GetVerticalScrollPosition()
1508 return mImpl->GetVerticalScrollPosition();
1511 void Controller::DecorationEvent(HandleType handleType, HandleState state, float x, float y)
1513 EventHandler::DecorationEvent(*this, handleType, state, x, y);
1516 void Controller::TextPopupButtonTouched(Dali::Toolkit::TextSelectionPopup::Buttons button)
1518 EventHandler::TextPopupButtonTouched(*this, button);
1521 void Controller::DisplayTimeExpired()
1523 mImpl->mEventData->mUpdateCursorPosition = true;
1524 // Apply modifications to the model
1525 mImpl->mOperationsPending = ALL_OPERATIONS;
1527 mImpl->RequestRelayout();
1530 void Controller::InsertText(const std::string& text, Controller::InsertType type)
1532 TextUpdater::InsertText(*this, text, type);
1535 void Controller::PasteText(const std::string& stringToPaste)
1537 TextUpdater::PasteText(*this, stringToPaste);
1540 bool Controller::RemoveText(int cursorOffset, int numberOfCharacters, UpdateInputStyleType type)
1542 return TextUpdater::RemoveText(*this, cursorOffset, numberOfCharacters, type);
1545 bool Controller::RemoveSelectedText()
1547 return TextUpdater::RemoveSelectedText(*this);
1550 void Controller::InsertTextAnchor(int numberOfCharacters, CharacterIndex previousCursorIndex)
1552 TextUpdater::InsertTextAnchor(*this, numberOfCharacters, previousCursorIndex);
1555 void Controller::RemoveTextAnchor(int cursorOffset, int numberOfCharacters, CharacterIndex previousCursorIndex)
1557 TextUpdater::RemoveTextAnchor(*this, cursorOffset, numberOfCharacters, previousCursorIndex);
1560 bool Controller::DoRelayout(const Size& size, OperationsMask operationsRequired, Size& layoutSize)
1562 return Relayouter::DoRelayout(*this, size, operationsRequired, layoutSize);
1565 void Controller::CalculateVerticalOffset(const Size& controlSize)
1567 Relayouter::CalculateVerticalOffset(*this, controlSize);
1570 void Controller::ProcessModifyEvents()
1572 EventHandler::ProcessModifyEvents(*this);
1575 void Controller::TextReplacedEvent()
1577 EventHandler::TextReplacedEvent(*this);
1580 void Controller::TextInsertedEvent()
1582 EventHandler::TextInsertedEvent(*this);
1585 void Controller::TextDeletedEvent()
1587 EventHandler::TextDeletedEvent(*this);
1590 bool Controller::DeleteEvent(int keyCode)
1592 return EventHandler::DeleteEvent(*this, keyCode);
1595 // private : Helpers.
1597 void Controller::ResetText()
1599 TextUpdater::ResetText(*this);
1602 void Controller::ShowPlaceholderText()
1604 PlaceholderHandler::ShowPlaceholderText(*this);
1607 void Controller::ResetCursorPosition(CharacterIndex cursorIndex)
1609 // Reset the cursor position
1610 if(NULL != mImpl->mEventData)
1612 mImpl->mEventData->mPrimaryCursorPosition = cursorIndex;
1614 // Update the cursor if it's in editing mode.
1615 if(EventData::IsEditingState(mImpl->mEventData->mState))
1617 mImpl->mEventData->mUpdateCursorPosition = true;
1622 CharacterIndex Controller::GetCursorPosition()
1624 return mImpl->mEventData ? mImpl->mEventData->mPrimaryCursorPosition : 0;
1627 void Controller::SetControlInterface(ControlInterface* controlInterface)
1629 mImpl->mControlInterface = controlInterface;
1632 void Controller::SetAnchorControlInterface(AnchorControlInterface* anchorControlInterface)
1634 mImpl->mAnchorControlInterface = anchorControlInterface;
1637 bool Controller::ShouldClearFocusOnEscape() const
1639 return mImpl->mShouldClearFocusOnEscape;
1642 Actor Controller::CreateBackgroundActor()
1644 return mImpl->CreateBackgroundActor();
1647 void Controller::GetAnchorActors(std::vector<Toolkit::TextAnchor>& anchorActors)
1649 mImpl->GetAnchorActors(anchorActors);
1652 int Controller::GetAnchorIndex(size_t characterOffset)
1654 return mImpl->GetAnchorIndex(characterOffset);
1657 Controller::Controller(ControlInterface* controlInterface,
1658 EditableControlInterface* editableControlInterface,
1659 SelectableControlInterface* selectableControlInterface,
1660 AnchorControlInterface* anchorControlInterface)
1661 : mImpl(new Controller::Impl(controlInterface, editableControlInterface, selectableControlInterface, anchorControlInterface))
1665 Controller::~Controller()
1670 } // namespace Dali::Toolkit::Text