X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;ds=sidebyside;f=dali-toolkit%2Fpublic-api%2Fcontrols%2Fcontrol-impl.h;h=9a68ca19ea2fc0f17ec5e9e9c55737d0432caeee;hb=HEAD;hp=e2d1ca43fe8a0129e1da872b707945a913c2ab11;hpb=b3f769e350cf3c159ab22bd947f1e98d47cb4038;p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git diff --git a/dali-toolkit/public-api/controls/control-impl.h b/dali-toolkit/public-api/controls/control-impl.h index e2d1ca4..76991aa 100644 --- a/dali-toolkit/public-api/controls/control-impl.h +++ b/dali-toolkit/public-api/controls/control-impl.h @@ -2,7 +2,7 @@ #define DALI_TOOLKIT_CONTROL_IMPL_H /* - * Copyright (c) 2022 Samsung Electronics Co., Ltd. + * Copyright (c) 2023 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. @@ -43,9 +43,14 @@ namespace Toolkit class StyleManager; -namespace Internal +namespace DevelControl { +class ControlAccessible; + +} // namespace DevelControl +namespace Internal +{ /** * @brief This is the internal base class for all controls. * @@ -109,6 +114,34 @@ public: */ void ClearBackground(); + /** + * @copydoc Dali::Toolkit::Control::SetRenderEffect + */ + void SetRenderEffect(Toolkit::RenderEffect effect); + + /** + * @copydoc Dali::Toolkit::Control::ClearRenderEffect + */ + void ClearRenderEffect(); + + /** + * @brief Called when resources of control are ready. this api does not request relayout. + */ + void SetResourceReady(); + + // Accessibility + + /** + * @brief Gets the Accessible object that represents this control. + * + * This method calls CreateAccessibleObject() if CreateAccessible is true. + * + * @return The Accessible object + * + * @see CreateAccessibleObject() + */ + std::shared_ptr GetAccessibleObject(); + // Gesture Detection /** @@ -241,19 +274,12 @@ public: /// @cond internal /** - * @brief Called by the AccessibilityManager to activate the Control. - * @SINCE_1_0.0 - */ - DALI_INTERNAL void AccessibilityActivate(); - - /** * @brief Called by the KeyboardFocusManager. * @SINCE_1_0.0 */ DALI_INTERNAL void KeyboardEnter(); /// @endcond - // Signals /** @@ -382,7 +408,6 @@ protected: // From CustomActorImpl void OnLayoutNegotiated(float size, Dimension::Type dimension) override; public: // Helpers for deriving classes - /** * @brief Flags for the constructor. * @SINCE_1_0.0 @@ -437,6 +462,11 @@ public: // API for derived classes to override */ virtual void OnInitialize(); + /** + * @copydoc Dali::Toolkit::Control::IsResourceReady + */ + virtual bool IsResourceReady() const; + // Styling /** @@ -488,6 +518,24 @@ public: // API for derived classes to override */ virtual bool OnAccessibilityZoom(); + /** + * @brief This method should be overriden by deriving classes when they wish to be + * represented by a custom Accessible object implementation. + * + * The AT-SPI infrastructure is responsible for destroying the returned object. + * + * Currently, this method is called at most once in a given Control's lifetime, when + * GetAccessibleObject() is called for the first time. A future version of the + * AT-SPI infrastructure, however, may delete the Accessible object and request a new + * one to be created (by calling this method) multiple times, for example during + * scene connection and disconnection. + * + * @return The newly created Accessible object + * + * @see GetAccessibleObject() + */ + virtual DevelControl::ControlAccessible* CreateAccessibleObject(); + // Keyboard focus /** @@ -641,8 +689,7 @@ public: // API for derived classes to override * @param[in] destination Destination control of the animation. * @param[in] visualIndex Property::Index to make animation. */ - void MakeVisualTransition(Dali::Property::Map& sourcePropertyMap, Dali::Property::Map& destinationPropertyMap, - Dali::Toolkit::Control source, Dali::Toolkit::Control destination, Dali::Property::Index visualIndex); + void MakeVisualTransition(Dali::Property::Map& sourcePropertyMap, Dali::Property::Map& destinationPropertyMap, Dali::Toolkit::Control source, Dali::Toolkit::Control destination, Dali::Property::Index visualIndex); /** * @brief Retrieves source and destination visual properties for the Transition of this Control.