// EXTERNAL INCLUDES
#include <dali/public-api/common/intrusive-ptr.h>
+#include <dali/public-api/events/key-event.h>
#include <dali/public-api/math/vector3.h>
#include <dali/public-api/math/vector2.h>
#include <dali/public-api/object/ref-object.h>
LAYOUT = 0x0080,
UPDATE_ACTUAL_SIZE = 0x0100,
UPDATE_POSITIONS = 0x0200,
- REORDER = 0x0400,
- ALIGNMENT = 0x0800,
- RENDER = 0x1000,
+ UPDATE_LINES = 0x0400,
+ REORDER = 0x0800,
+ ALIGNMENT = 0x1000,
+ RENDER = 0x2000,
ALL_OPERATIONS = 0xFFFF
};
void GetText( std::string& text ) const;
/**
+ * @brief Replaces any placeholder text previously set.
+ *
+ * @param[in] text A string of UTF-8 characters.
+ */
+ void SetPlaceholderText( const std::string& text );
+
+ /**
+ * @brief Retrieve any placeholder text previously set.
+ *
+ * @return A string of UTF-8 characters.
+ */
+ void GetPlaceholderText( std::string& text ) const;
+
+ /**
* @brief Set the default font family.
*
* @param[in] defaultFontFamily The default font family.
*
* @param[in] size A the size of a bounding box to layout text within.
* @param[in] operations The layout operations which need to be done.
+ * @param[out] layoutSize The size of the laid-out text.
*/
- bool DoRelayout( const Vector2& size, OperationsMask operations );
+ bool DoRelayout( const Vector2& size,
+ OperationsMask operations,
+ Size& layoutSize );
/**
* @copydoc Control::GetNaturalSize()
void KeyboardFocusLostEvent();
/**
+ * @brief Caller by editable UI controls when key events are received.
+ *
+ * @param[in] event The key event.
+ */
+ bool KeyEvent( const Dali::KeyEvent& event );
+
+ /**
* @brief Caller by editable UI controls when a tap gesture occurs.
* @param[in] tapCount The number of taps.
* @param[in] x The x position relative to the top-left of the parent control.