-#ifndef __DALI_TOOLKIT_CONTROL_H__
-#define __DALI_TOOLKIT_CONTROL_H__
+#ifndef DALI_TOOLKIT_CONTROL_H
+#define DALI_TOOLKIT_CONTROL_H
/*
- * Copyright (c) 2017 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2022 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.
*/
// EXTERNAL INCLUDES
+#include <dali-toolkit/public-api/dali-toolkit-common.h>
#include <dali/public-api/actors/custom-actor.h>
-#include <dali/public-api/common/dali-common.h>
#include <dali/public-api/events/long-press-gesture-detector.h>
#include <dali/public-api/events/pan-gesture-detector.h>
#include <dali/public-api/events/pinch-gesture-detector.h>
#include <dali/public-api/events/tap-gesture-detector.h>
-#include <dali/public-api/events/tap-gesture-detector.h>
-#include <dali/public-api/images/image.h>
+
+// INTERNAL INCLUDES
+#include <dali-toolkit/public-api/visuals/visual-properties.h>
namespace Dali
{
-
namespace Toolkit
{
-
//Forward declarations.
namespace Internal
* |------------------------|----------------------------------------------------|
* | accessibilityActivated | %OnAccessibilityActivated() |
*/
-class DALI_IMPORT_API Control : public CustomActor
+class DALI_TOOLKIT_API Control : public CustomActor
{
public:
-
/**
* @brief Enumeration for the start and end property ranges for control.
* @SINCE_1_0.0
*/
enum PropertyRange
{
- PROPERTY_START_INDEX = PROPERTY_REGISTRATION_START_INDEX, ///< Start index is used by the property registration macro. @SINCE_1_0.0
- CONTROL_PROPERTY_START_INDEX = PROPERTY_START_INDEX, ///< Start index of Control properties. @SINCE_1_0.0
- CONTROL_PROPERTY_END_INDEX = CONTROL_PROPERTY_START_INDEX + 1000 ///< Reserving 1000 property indices. @SINCE_1_0.0
+ PROPERTY_START_INDEX = PROPERTY_REGISTRATION_START_INDEX, ///< Start index is used by the property registration macro. @SINCE_1_0.0
+ CONTROL_PROPERTY_START_INDEX = PROPERTY_START_INDEX, ///< Start index of Control properties. @SINCE_1_0.0
+ CONTROL_PROPERTY_END_INDEX = CONTROL_PROPERTY_START_INDEX + 1000 ///< Reserving 1000 property indices. @SINCE_1_0.0
};
/**
STYLE_NAME = PROPERTY_START_INDEX,
/**
- * @DEPRECATED_1_1.3
- * @brief The background color of the control.
- *
- * Mutually exclusive with BACKGROUND_IMAGE & BACKGROUND.
- * @details Name "backgroundColor", type Property::VECTOR4.
- * @see Toolkit::Control::SetStyleName()
- * @SINCE_1_0.0
- */
- BACKGROUND_COLOR,
-
- /**
- * @DEPRECATED_1_1.3
- * @brief The background image of the control.
- *
- * Mutually exclusive with BACKGROUND_COLOR & BACKGROUND.
- * @details Name "backgroundImage", type Property::MAP.
- * @SINCE_1_0.0
- */
- BACKGROUND_IMAGE,
-
- /**
* @brief Receives key events to the control.
* @details Name "keyInputFocus", type Property::BOOLEAN.
* @see Toolkit::Control::SetKeyInputFocus()
/**
* @brief The background of the control.
*
- * Mutually exclusive with BACKGROUND_COLOR & BACKGROUND_IMAGE.
* @details Name "background", type Property::MAP or std::string for URL or Property::VECTOR4 for Color.
* @SINCE_1_1.3
*/
*/
enum Direction
{
- LEFT, ///< Move keyboard focus towards the left direction @SINCE_1_0.0
- RIGHT, ///< Move keyboard focus towards the right direction @SINCE_1_0.0
- UP, ///< Move keyboard focus towards the up direction @SINCE_1_0.0
- DOWN, ///< Move keyboard focus towards the down direction @SINCE_1_0.0
- PAGE_UP, ///< Move keyboard focus towards the previous page direction @SINCE_1_2.14
- PAGE_DOWN ///< Move keyboard focus towards the next page direction @SINCE_1_2.14
+ LEFT, ///< Move keyboard focus towards the left direction @SINCE_1_0.0
+ RIGHT, ///< Move keyboard focus towards the right direction @SINCE_1_0.0
+ UP, ///< Move keyboard focus towards the up direction @SINCE_1_0.0
+ DOWN, ///< Move keyboard focus towards the down direction @SINCE_1_0.0
+ PAGE_UP, ///< Move keyboard focus towards the previous page direction @SINCE_1_2.14
+ PAGE_DOWN, ///< Move keyboard focus towards the next page direction @SINCE_1_2.14
+ FORWARD, ///< Move keyboard focus towards the forward direction @SINCE_2_1.10
+ BACKWARD, ///< Move keyboard focus towards the backward direction @SINCE_2_1.10
+ CLOCKWISE, ///< Move keyboard focus towards the clockwise direction @SINCE_2_1.14
+ COUNTER_CLOCKWISE, ///< Move keyboard focus towards the counter clockwise direction @SINCE_2_1.14
};
};
// Typedefs
/// @brief Key Event signal type. @SINCE_1_0.0
- typedef Signal<bool ( Control, const KeyEvent& ) > KeyEventSignalType;
+ typedef Signal<bool(Control, const KeyEvent&)> KeyEventSignalType;
/// @brief Key InputFocusType signal type. @SINCE_1_0.0
- typedef Signal<void ( Control ) > KeyInputFocusSignalType;
+ typedef Signal<void(Control)> KeyInputFocusSignalType;
/// @brief ResourceReady signal type. @SINCE_1_2.60
- typedef Signal<void ( Control ) > ResourceReadySignalType;
+ typedef Signal<void(Control)> ResourceReadySignalType;
public: // Creation & Destruction
/**
+ * @brief Additional control behaviour flags for the control constructor.
+ * @note TODO : Currunt code is hard-coded. We Should sync type values as
+ * CustomActorImpl::ActorFlag and Internal::Control::ControlBehaviour in future.
+ * @SINCE_2_1.8
+ */
+ enum ControlBehaviour
+ {
+ CONTROL_BEHAVIOUR_DEFAULT = 0, ///< Default behaviour: Size negotiation is enabled & listens to Style Change signal, but doesn't receive event callbacks. @SINCE_1_2_10
+ DISABLE_SIZE_NEGOTIATION = 1 << (0 + 0), ///< True if control does not need size negotiation, i.e. it can be skipped in the algorithm @SINCE_1_0.0
+ REQUIRES_KEYBOARD_NAVIGATION_SUPPORT = 1 << (4 + 1), ///< True if needs to support keyboard navigation @SINCE_1_0.0
+ DISABLE_STYLE_CHANGE_SIGNALS = 1 << (4 + 2), ///< True if control should not monitor style change signals @SINCE_1_2_10
+ };
+
+ /**
* @brief Creates a new instance of a Control.
*
* @SINCE_1_0.0
static Control New();
/**
+ * @brief Creates a new instance of a Control with additional behaviour.
+ *
+ * @SINCE_2_1.8
+ * @param[in] additionalBehaviour Additional control behaviour
+ * @return A handle to a new Control
+ */
+ static Control New(ControlBehaviour additionalBehaviour);
+
+ /**
* @brief Creates an uninitialized Control handle.
*
* Only derived versions can be instantiated. Calling member
Control(const Control& uiControl);
/**
+ * @brief Move constructor.
+ *
+ * @SINCE_1_9.23
+ * @param[in] rhs Handle to move
+ */
+ Control(Control&& rhs) noexcept;
+
+ /**
* @brief Dali::Control is intended as a base class.
*
* This is non-virtual since derived Handle types must not contain data or virtual methods.
~Control();
public: // operators
-
/**
- * @brief Assignment operator.
+ * @brief Copy assignment operator.
*
* Changes this handle to point to another real object.
* @SINCE_1_0.0
* @param[in] handle Object to assign this to
* @return Reference to this
*/
- Control& operator=( const Control& handle );
+ Control& operator=(const Control& handle);
-public:
+ /**
+ * @brief Move assignment operator.
+ *
+ * @SINCE_1_9.23
+ * @param[in] rhs Object to assign this to
+ * @return Reference to this
+ */
+ Control& operator=(Control&& rhs) noexcept;
+public:
/**
* @brief Downcasts a handle to Control handle.
*
* @param[in] handle Handle to an object
* @return A handle to a Control or an uninitialized handle
*/
- static Control DownCast( BaseHandle handle );
+ static Control DownCast(BaseHandle handle);
// Key Input
* @SINCE_1_0.0
* @param[in] styleName A string matching a style described in a stylesheet
*/
- void SetStyleName( const std::string& styleName );
+ void SetStyleName(const std::string& styleName);
/**
* @brief Retrieves the name of the style to be applied to the control (if any).
*
* @note The background color fully blends with the actor color.
*/
- void SetBackgroundColor( const Vector4& color );
-
- /**
- * @DEPRECATED_1_1.3
- *
- * @brief Retrieves the background color of the control.
- *
- * @SINCE_1_0.0
- * @return The background color of the control
- */
- Vector4 GetBackgroundColor() const DALI_DEPRECATED_API;
-
- /**
- * @DEPRECATED_1_2_8, use Property::BACKGROUND instead
- *
- * @brief Sets an image as the background of the control.
- *
- * @SINCE_1_0.0
- * @param[in] image The image to set as the background
- */
- void SetBackgroundImage( Image image ) DALI_DEPRECATED_API;
+ void SetBackgroundColor(const Vector4& color);
/**
* @brief Clears the background.
*/
bool IsResourceReady() const;
+ /**
+ * @brief Get the loading state of the visual resource.
+ *
+ * @SINCE_1_3_5
+ * @param[in] index The Property index of the visual
+ * @return Return the loading status (PREPARING, READY and FAILED) of visual resource
+ */
+ Visual::ResourceStatus GetVisualResourceStatus(const Dali::Property::Index index);
+
// Signals
/**
ResourceReadySignalType& ResourceReadySignal();
public: // Intended for control developers
-
/**
* @brief Creates an initialized Control.
*
* @SINCE_1_0.0
* @param[in] implementation The implementation for this control
- * @return A handle to a newly allocated Dali resource
* @note Should NOT be called to create a handle from the implementation. As stated, this allocates a NEW Dali resource.
*/
explicit Control(Internal::Control& implementation);
explicit Control(Dali::Internal::CustomActor* internal);
public: // Templates for Deriving Classes
-
/**
* @brief Template to allow deriving controls to DownCast handles to deriving handle classes.
*
* @see DownCast(BaseHandle)
*/
template<typename T, typename I>
- DALI_INTERNAL static T DownCast( BaseHandle handle )
+ DALI_INTERNAL static T DownCast(BaseHandle handle)
{
T result;
- CustomActor custom = Dali::CustomActor::DownCast( handle );
- if ( custom )
+ CustomActor custom = Dali::CustomActor::DownCast(handle);
+ if(custom)
{
CustomActorImpl& customImpl = custom.GetImplementation();
I* impl = dynamic_cast<I*>(&customImpl);
- if (impl)
+ if(impl)
{
result = T(customImpl.GetOwner());
}
{
// Can have a NULL pointer so we only need to check if the internal implementation is our class
// when there is a value.
- if (internal)
+ if(internal)
{
DALI_ASSERT_DEBUG(dynamic_cast<I*>(&CustomActor(internal).GetImplementation()));
}
}
-
};
/**
} // namespace Dali
-#endif // __DALI_TOOLKIT_CONTROL_H__
+#endif // DALI_TOOLKIT_CONTROL_H