X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=dali-toolkit%2Fpublic-api%2Fcontrols%2Fcontrol-impl.h;h=9c156d4ba0cc687b795d5dc424318c752d041590;hb=5297db6ed640ac8f54b0c7681fdd0dc7fc6ca221;hp=0a3584e17eaaba0ba4f982f88b294f1ab1d752e0;hpb=0512ac82e2c23d8eada7840b5a72cdabe13a5f54;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 0a3584e..9c156d4 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. @@ -51,7 +51,6 @@ class ControlAccessible; namespace Internal { - /** * @brief This is the internal base class for all controls. * @@ -115,14 +114,21 @@ public: */ void ClearBackground(); + /** + * @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 creates the Accessible object if necessary, so a non-null return is expected. + * This method calls CreateAccessibleObject() if CreateAccessible is true. * * @return The Accessible object + * + * @see CreateAccessibleObject() */ Toolkit::DevelControl::ControlAccessible* GetAccessibleObject(); @@ -270,7 +276,6 @@ public: DALI_INTERNAL void KeyboardEnter(); /// @endcond - // Signals /** @@ -399,7 +404,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 @@ -454,6 +458,11 @@ public: // API for derived classes to override */ virtual void OnInitialize(); + /** + * @copydoc Dali::Toolkit::Control::IsResourceReady + */ + virtual bool IsResourceReady() const; + // Styling /** @@ -505,6 +514,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 /** @@ -658,8 +685,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.