Add CanvasView::New() API that can be created without viewbox.
[platform/core/uifw/dali-toolkit.git] / dali-toolkit / devel-api / controls / control-devel.cpp
index 59fd144..55becb3 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2017 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2021 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.
 #include "control-devel.h"
 
 // EXTERNAL INCLUDES
+#include <dali/public-api/actors/actor.h>
 #include <dali/public-api/animation/animation.h>
 
 // INTERNAL INCLUDES
+#include <dali-toolkit/devel-api/visual-factory/transition-data.h>
 #include <dali-toolkit/internal/controls/control/control-data-impl.h>
 #include <dali-toolkit/public-api/controls/control-impl.h>
-#include <dali-toolkit/devel-api/visual-factory/transition-data.h>
+#include <dali-toolkit/public-api/controls/control.h>
 
 namespace Dali
 {
-
 namespace Toolkit
 {
-
 namespace DevelControl
 {
+void RegisterVisual(Internal::Control& control, Dali::Property::Index index, Toolkit::Visual::Base& visual)
+{
+  Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(control);
+  controlDataImpl.RegisterVisual(index, visual);
+}
+
+void RegisterVisual(Internal::Control& control, Dali::Property::Index index, Toolkit::Visual::Base& visual, int depthIndex)
+{
+  Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(control);
+  controlDataImpl.RegisterVisual(index, visual, depthIndex);
+}
+
+void RegisterVisual(Internal::Control& control, Dali::Property::Index index, Toolkit::Visual::Base& visual, bool enabled)
+{
+  Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(control);
+  controlDataImpl.RegisterVisual(index, visual, enabled);
+}
+
+void RegisterVisual(Internal::Control& control, Dali::Property::Index index, Toolkit::Visual::Base& visual, bool enabled, int depthIndex)
+{
+  Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(control);
+  controlDataImpl.RegisterVisual(index, visual, enabled, depthIndex);
+}
+
+void UnregisterVisual(Internal::Control& control, Dali::Property::Index index)
+{
+  Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(control);
+  controlDataImpl.UnregisterVisual(index);
+}
+
+Toolkit::Visual::Base GetVisual(const Internal::Control& control, Dali::Property::Index index)
+{
+  const Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(control);
+  return controlDataImpl.GetVisual(index);
+}
+
+void EnableVisual(Internal::Control& control, Dali::Property::Index index, bool enable)
+{
+  Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(control);
+  controlDataImpl.EnableVisual(index, enable);
+}
+
+bool IsVisualEnabled(const Internal::Control& control, Dali::Property::Index index)
+{
+  const Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(control);
+  return controlDataImpl.IsVisualEnabled(index);
+}
+
+Dali::Animation CreateTransition(Internal::Control& control, const Toolkit::TransitionData& handle)
+{
+  Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(control);
+  return controlDataImpl.CreateTransition(handle);
+}
 
-ResourceReadySignalType&  ResourceReadySignal( Control& control )
+void AddTransitions(Internal::Control&             control,
+                    Dali::Animation                animation,
+                    const Toolkit::TransitionData& transitionData)
 {
-  Internal::Control& internalControl = Toolkit::Internal::GetImplementation(control);
-  Internal::Control::Impl& controlImpl = Internal::Control::Impl::Get( internalControl );
+  Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(control);
+  controlDataImpl.AddTransitions(animation, transitionData);
+}
 
-  return controlImpl.mResourceReadySignal;
+void DoAction(Control& control, Dali::Property::Index visualIndex, Dali::Property::Index actionId, const Dali::Property::Value attributes)
+{
+  Internal::Control&       controlInternal = Toolkit::Internal::GetImplementation(control);
+  Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(controlInternal);
+  controlDataImpl.DoAction(visualIndex, actionId, attributes);
 }
 
-bool IsResourceReady( const Control& control )
+void SetInputMethodContext(Internal::Control& control, InputMethodContext& inputMethodContext)
 {
-  const Internal::Control& internalControl = Toolkit::Internal::GetImplementation(control);
-  const Internal::Control::Impl& controlImpl = Internal::Control::Impl::Get( internalControl );
+  Internal::Control::Impl::Get(control).SetInputMethodContext(inputMethodContext);
+}
 
-  return controlImpl.IsResourceReady();
+VisualEventSignalType& VisualEventSignal(Control control)
+{
+  Internal::Control&       internalControl = Toolkit::Internal::GetImplementation(control);
+  Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(internalControl);
+  return controlDataImpl.VisualEventSignal();
 }
 
-void RegisterVisual( Internal::Control& control, Dali::Property::Index index, Toolkit::Visual::Base& visual )
+Dali::Property GetVisualProperty(Control control, Dali::Property::Index index, Dali::Property::Key visualPropertyKey)
 {
-  Internal::Control::Impl& controlImpl = Internal::Control::Impl::Get( control );
-  controlImpl.RegisterVisual( index, visual );
+  Internal::Control&       internalControl = Toolkit::Internal::GetImplementation(control);
+  Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(internalControl);
+  return controlDataImpl.GetVisualProperty(index, visualPropertyKey);
 }
 
-void RegisterVisual( Internal::Control& control, Dali::Property::Index index, Toolkit::Visual::Base& visual, int depthIndex )
+void CreateTransitions(Control control, Dali::Animation& animation, Dali::Toolkit::Control source, AlphaFunction alphaFunction, TimePeriod timePeriod)
 {
-  Internal::Control::Impl& controlImpl = Internal::Control::Impl::Get( control );
-  controlImpl.RegisterVisual( index, visual, depthIndex );
+  if(animation)
+  {
+    // make visual transition of control visual.
+    Internal::Control&       internalControl = Toolkit::Internal::GetImplementation(control);
+    Internal::Control::Impl& controlDataImpl = Internal::Control::Impl::Get(internalControl);
+    controlDataImpl.MakeVisualTransition(animation, source, Toolkit::Control::Property::BACKGROUND, alphaFunction, timePeriod);
+    controlDataImpl.MakeVisualTransition(animation, source, Toolkit::DevelControl::Property::SHADOW, alphaFunction, timePeriod);
+    internalControl.OnCreateTransitions(animation, source, alphaFunction, timePeriod);
+  }
 }
 
-void RegisterVisual( Internal::Control& control, Dali::Property::Index index, Toolkit::Visual::Base& visual, bool enabled )
+static Toolkit::Internal::Control::Impl* GetControlImplementation(Dali::Actor actor)
 {
-  Internal::Control::Impl& controlImpl = Internal::Control::Impl::Get( control );
-  controlImpl.RegisterVisual( index, visual, enabled );
+  Dali::Toolkit::Control control = Toolkit::Control::DownCast(actor);
+  if(control)
+  {
+    auto& internalControl = Toolkit::Internal::GetImplementation(control);
+    auto& controlDataImpl = Toolkit::Internal::Control::Impl::Get(internalControl);
+    return &controlDataImpl;
+  }
+  return nullptr;
 }
 
-void RegisterVisual( Internal::Control& control, Dali::Property::Index index, Toolkit::Visual::Base& visual, bool enabled, int depthIndex )
+Toolkit::DevelControl::AccessibilityActivateSignalType& AccessibilityActivateSignal(Toolkit::Control control)
 {
-  Internal::Control::Impl& controlImpl = Internal::Control::Impl::Get( control );
-  controlImpl.RegisterVisual( index, visual, enabled, depthIndex );
+  return GetControlImplementation(control)->mAccessibilityActivateSignal;
 }
 
-void UnregisterVisual( Internal::Control& control, Dali::Property::Index index )
+Toolkit::DevelControl::AccessibilityReadingSkippedSignalType& AccessibilityReadingSkippedSignal(Toolkit::Control control)
 {
-  Internal::Control::Impl& controlImpl = Internal::Control::Impl::Get( control );
-  controlImpl.UnregisterVisual( index );
+  return GetControlImplementation(control)->mAccessibilityReadingSkippedSignal;
 }
 
-Toolkit::Visual::Base GetVisual( const Internal::Control& control, Dali::Property::Index index )
+Toolkit::DevelControl::AccessibilityReadingPausedSignalType& AccessibilityReadingPausedSignal(Toolkit::Control control)
 {
-  const Internal::Control::Impl& controlImpl = Internal::Control::Impl::Get( control );
-  return controlImpl.GetVisual( index );
+  return GetControlImplementation(control)->mAccessibilityReadingPausedSignal;
 }
 
-void EnableVisual( Internal::Control& control, Dali::Property::Index index, bool enable )
+Toolkit::DevelControl::AccessibilityReadingResumedSignalType& AccessibilityReadingResumedSignal(Toolkit::Control control)
 {
-  Internal::Control::Impl& controlImpl = Internal::Control::Impl::Get( control );
-  controlImpl.EnableVisual( index, enable );
+  return GetControlImplementation(control)->mAccessibilityReadingResumedSignal;
 }
 
-bool IsVisualEnabled( const Internal::Control& control, Dali::Property::Index index )
+Toolkit::DevelControl::AccessibilityReadingCancelledSignalType& AccessibilityReadingCancelledSignal(Toolkit::Control control)
 {
-  const Internal::Control::Impl& controlImpl = Internal::Control::Impl::Get( control );
-  return controlImpl.IsVisualEnabled( index );
+  return GetControlImplementation(control)->mAccessibilityReadingCancelledSignal;
 }
 
-Dali::Animation CreateTransition( Internal::Control& control, const Toolkit::TransitionData& handle )
+Toolkit::DevelControl::AccessibilityReadingStoppedSignalType& AccessibilityReadingStoppedSignal(Toolkit::Control control)
 {
-  Internal::Control::Impl& controlImpl = Internal::Control::Impl::Get( control );
-  return controlImpl.CreateTransition( handle );
+  return GetControlImplementation(control)->mAccessibilityReadingStoppedSignal;
 }
 
+Toolkit::DevelControl::AccessibilityGetNameSignalType& AccessibilityGetNameSignal(Toolkit::Control control)
+{
+  return GetControlImplementation(control)->mAccessibilityGetNameSignal;
+}
+
+Toolkit::DevelControl::AccessibilityGetDescriptionSignalType& AccessibilityGetDescriptionSignal(Toolkit::Control control)
+{
+  return GetControlImplementation(control)->mAccessibilityGetDescriptionSignal;
+}
+
+Toolkit::DevelControl::AccessibilityDoGestureSignalType& AccessibilityDoGestureSignal(Toolkit::Control control)
+{
+  return GetControlImplementation(control)->mAccessibilityDoGestureSignal;
+}
+
+void AppendAccessibilityRelation(Dali::Actor control, Actor destination, Dali::Accessibility::RelationType relation)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    auto index = static_cast<Dali::Property::Array::SizeType>(relation);
+    if(index >= controlDataImpl->mAccessibilityRelations.size())
+    {
+      DALI_LOG_ERROR("Relation index exceeds vector size.");
+      return;
+    }
+
+    auto object = controlDataImpl->GetAccessibilityObject(destination);
+    if(object)
+    {
+      controlDataImpl->mAccessibilityRelations[index].push_back(object->GetAddress());
+    }
+  }
+}
+
+void RemoveAccessibilityRelation(Dali::Actor control, Actor destination, Dali::Accessibility::RelationType relation)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    auto index = static_cast<Dali::Property::Array::SizeType>(relation);
+    if(index >= controlDataImpl->mAccessibilityRelations.size())
+    {
+      DALI_LOG_ERROR("Relation index exceeds vector size.");
+      return;
+    }
+
+    auto object = controlDataImpl->GetAccessibilityObject(destination);
+    if(!object)
+    {
+      return;
+    }
+
+    auto address = object->GetAddress();
+
+    auto& targets = controlDataImpl->mAccessibilityRelations[index];
+    for(auto i = 0u; i < targets.size(); ++i)
+    {
+      if(targets[i].ToString() == address.ToString())
+      {
+        targets[i] = targets.back();
+        targets.erase(targets.end() - 1);
+      }
+    }
+  }
+}
+
+std::vector<std::vector<Accessibility::Address>> GetAccessibilityRelations(Dali::Actor control)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    return controlDataImpl->mAccessibilityRelations;
+  }
+  return {};
+}
+
+void ClearAccessibilityRelations(Dali::Actor control)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    for(auto& it : controlDataImpl->mAccessibilityRelations)
+    {
+      it.clear();
+    }
+  }
+}
+
+void SetAccessibilityConstructor(Dali::Actor control, std::function<std::unique_ptr<Dali::Accessibility::Accessible>(Dali::Actor)> constructor)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    controlDataImpl->mAccessibilityConstructor = constructor;
+  }
+}
+
+void AppendAccessibilityAttribute(Dali::Actor control, const std::string& key, const std::string value)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    controlDataImpl->AppendAccessibilityAttribute(key, value);
+  }
+}
+
+void RemoveAccessibilityAttribute(Dali::Actor control, const std::string& key)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    controlDataImpl->RemoveAccessibilityAttribute(key);
+  }
+}
+
+void ClearAccessibilityAttributes(Dali::Actor control)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    controlDataImpl->ClearAccessibilityAttributes();
+  }
+}
+
+void SetAccessibilityReadingInfoType(Dali::Actor control, const Dali::Accessibility::ReadingInfoTypes types)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    controlDataImpl->SetAccessibilityReadingInfoType(types);
+  }
+}
+
+Dali::Accessibility::ReadingInfoTypes GetAccessibilityReadingInfoType(Dali::Actor control)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    return controlDataImpl->GetAccessibilityReadingInfoType();
+  }
+  return {};
+}
+
+bool ClearAccessibilityHighlight(Dali::Actor control)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    auto object = dynamic_cast<Dali::Accessibility::Component*>(controlDataImpl->GetAccessibilityObject());
+    if(object)
+    {
+      return object->ClearHighlight();
+    }
+  }
+  return false;
+}
+
+bool GrabAccessibilityHighlight(Dali::Actor control)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    auto object = dynamic_cast<Dali::Accessibility::Component*>(controlDataImpl->GetAccessibilityObject());
+    if(object)
+    {
+      return object->GrabHighlight();
+    }
+  }
+  return false;
+}
+
+Dali::Accessibility::States GetAccessibilityStates(Dali::Actor control)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    auto object = dynamic_cast<Dali::Accessibility::Component*>(controlDataImpl->GetAccessibilityObject());
+    if(object)
+    {
+      return object->GetStates();
+    }
+  }
+  return {};
+}
+
+void NotifyAccessibilityStateChange(Dali::Actor control, Dali::Accessibility::States states, bool isRecursive)
+{
+  if(auto controlDataImpl = GetControlImplementation(control))
+  {
+    controlDataImpl->GetAccessibilityObject()->NotifyAccessibilityStateChange(std::move(states), isRecursive);
+  }
+}
+
+Dali::Accessibility::Accessible* GetBoundAccessibilityObject(Dali::Actor control)
+{
+  return Dali::Accessibility::Accessible::Get(control);
+}
 
 } // namespace DevelControl