*/
DALI_TOOLKIT_API void SetInputMethodContext( Internal::Control& control, InputMethodContext& inputMethodContext );
-/*
+/**
* @brief Get the layout associated with this control, if any.
*
* @return A handle to the layout, or empty.
*/
DALI_TOOLKIT_API Toolkit::LayoutItem GetLayout( Internal::Control& control );
-/*
+/**
* @brief Get the layout associated with a control, if any.
*
* @return A handle to the layout, or empty.
*
* @param[in] control The internal Control to set the layout on
* @param[in] layout Pointer to the layout
+ * @note Providing an empty layout will remove the current layout and
+ * replace it with a BinLayout.
+ * Setting a layout that has already been set will result in the
+ * original control becoming a BinLayout. Two Controls can not share
+ * the same layout.
*/
DALI_TOOLKIT_API void SetLayout( Internal::Control& control, Toolkit::LayoutItem layout );
*
* @param[in] control The Control to set the layout on
* @param[in] layout Pointer to the layout
+ * @note Providing an empty layout will remove the current layout and
+ * replace it with a BinLayout.
*/
DALI_TOOLKIT_API void SetLayout( Control control, Toolkit::LayoutItem layout );
*/
DALI_TOOLKIT_API bool IsLayoutingRequired( Control control );
+/**
+ * @brief Visual Event signal type
+ */
+using VisualEventSignalType = Signal< void ( Control, Dali::Property::Index, Dali::Property::Index ) >;
+
+/**
+ * @brief This signal is emitted when a visual has an event to notify.
+ *
+ * A callback of the following type may be connected:
+ * @code
+ * void YourCallbackName( Control control, Dali::Property::Index visualIndex, Dali::Property::Index signalId );
+ * @endcode
+ * @return The signal to connect to
+ */
+DALI_TOOLKIT_API VisualEventSignalType& VisualEventSignal( Control control );
+
} // namespace DevelControl
} // namespace Toolkit