#ifndef __DALI_TOOLKIT_INTERNAL_TEXT_INPUT_H__
#define __DALI_TOOLKIT_INTERNAL_TEXT_INPUT_H__
-//
-// Copyright (c) 2014 Samsung Electronics Co., Ltd.
-//
-// Licensed under the Flora License, Version 1.0 (the License);
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://floralicense.org/license/
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an AS IS BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-//
+/*
+ * Copyright (c) 2014 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.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+// EXTERNAL INCLUDES
+#include <dali/public-api/actors/mesh-actor.h>
+#include <dali/public-api/adaptor-framework/clipboard.h>
+#include <dali/public-api/adaptor-framework/clipboard-event-notifier.h>
+#include <dali/public-api/adaptor-framework/imf-manager.h>
+#include <dali/public-api/adaptor-framework/timer.h>
+#include <dali/public-api/common/dali-vector.h>
+#include <dali/public-api/geometry/mesh.h>
// INTERNAL INCLUDES
#include <dali-toolkit/public-api/controls/control-impl.h>
#include <dali-toolkit/public-api/controls/buttons/push-button.h>
#include <dali-toolkit/internal/controls/text-input/text-input-popup-impl.h>
-#include <dali/public-api/common/dali-vector.h>
-#include <dali/public-api/adaptor-framework/common/imf-manager.h>
-#include <dali/public-api/geometry/mesh.h>
-
namespace Dali
{
{
public:
+ // Properties
+ enum
+ {
+ TEXTINPUT_PROPERTY_START_INDEX = Control::CONTROL_PROPERTY_END_INDEX + 1,
+ TEXTINPUT_PROPERTY_END_INDEX = TEXTINPUT_PROPERTY_START_INDEX + 512 ///< Reserving property indices
+ };
+
/**
* Create a new TextInput
* @return instrusive ptr to a TextInput
Toolkit::TextInput::StyleChangedSignalV2& StyleChangedSignal();
/**
+ * @copydoc Toolkit::TextInput::TextModifiedSignal()
+ */
+ Toolkit::TextInput::TextModifiedSignalType& TextModifiedSignal();
+
+ /**
* @copydoc Toolkit::TextInput::MaxInputCharactersReachedSignal()
*/
Toolkit::TextInput::MaxInputCharactersReachedSignalV2& MaxInputCharactersReachedSignal();
*/
std::size_t GetNumberOfCharacters() const;
+ /**
+ * Styling
+ */
+
+ /**
+ * Set the diffuse color for the highlight
+ * @param[in] color color to use
+ */
+ void SetMaterialDiffuseColor( const Vector4& color );
+
+ /**
+ * Get the diffuse color used by the highlight
+ * @return color
+ */
+ const Vector4& GetMaterialDiffuseColor() const;
+
private:
/**
bool OnKeyUpEvent(const KeyEvent& event);
/**
+ * Chooses from all handle position and alternative handle positions where to set the position of the two selection handles.
+ *
+ * @param[in] cursorPositionOne The initial position of the first selection handle.
+ * @param[in] cursorPositionTwo The initial position of the second selection handle.
+ * @param[in] altPositionValidOne Whether there is an alternative position for the first selection handle.
+ * @param[in] altPositionValidTwo Whether there is an alternative position for the second selection handle.
+ * @param[in] altPositionOne The alternative position of the first selection handle.
+ * @param[in] altPositionTwo The alternative position of the second selection handle.
+ */
+ void ChooseRtlSelectionHandlePosition( const Vector3& cursorPositionOne,
+ const Vector3& cursorPositionTwo,
+ bool altPositionValidOne,
+ bool altPositionValidTwo,
+ const Vector3& altPositionOne,
+ const Vector3& altPositionTwo );
+ /**
* Callback called when the text-view is scrolled.
*
* Updates the selection and grab handles, and the highlighted text.
std::size_t InsertAt( const Text& newText, const std::size_t insertionPosition, const std::size_t numberOfCharactersToReplace );
/**
- * Creates a cursor from the supplied image
- * @param[in] cursorImage the image to be used for the cursor.
- * @param[in] border the nine patch border corresponding to the supplied image.
- * @return the image actor to be used as the cursor.
- */
- ImageActor CreateCursor( Image cursorImage, const Vector4& border );
+ * Creates a cursor.
+ * @param[in] color the cursor color.
+ * @return the image actor to be used as the cursor.
+ */
+ ImageActor CreateCursor( const Vector4 &color );
/**
* Moves cursor to the right
/**
* Draw a cursor / caret at position where new text should appear
- * @param[in] nthChar the position along the text string in which new text should appear.
*/
- void DrawCursor(const std::size_t nthChar = 0);
+ void DrawCursor();
/**
* Sets cursor visibility
void SetSelectionHandlePosition(SelectionHandleId handleId);
/**
- * Gets the visual position of a logical position.
- * @note This is preferred over directly accessing the Map, as it resolves visual
- * positions outside of the character map range.
- * @param[in] logicalPosition The logical position
- * @return Visual position is returned.
- */
- std::size_t GetVisualPosition(std::size_t logicalPosition) const;
-
- /**
* Gets a table of the visual text positions which has a flag
* for each Character. The flag is either true (character selected)
* or false (character deselected)
HighlightInfo CalculateHighlightInfo();
/**
+ * This method was added to fix a PLM. it creates one quad per character so the mesh can show different selection boxes when a mix of right to left and left to right text is selected.
+ */
+ HighlightInfo CalculateHighlightInfoRtl();
+
+ /**
* Calculates new Mesh data so highlight moves with selection handles.
*/
void UpdateHighlight();
void ClearPopup();
/**
- * Adds a popup option.
- * @note Creates popup frame if not already created.
- * @param[in] name The unique name for this option.
- * @param[in] caption The caption (label) for this option
- * @param[in] icon the image icon to be displayed for this option
- * @param[in] finalOption Flag to indicate that this is the final option.
- * (set to true on the last option you add)
+ * Adds Popup options which have been enabled.
*/
- void AddPopupOption(const std::string& name, const std::string& caption, const Image icon, bool finalOption = false);
+ void AddPopupOptions();
/**
* Sets popup position
* @param[in] position The actual position for this popup.
+ * @param[in] alternativePosition Alternative popup position if no space in upper area.
*/
- void SetPopupPosition(const Vector3& position);
+ void SetPopupPosition(const Vector3& position, const Vector2& alternativePosition );
/**
* Hides the popup
/**
* Setup the selection popup and clipboard if relevant so the correct options are shown when ShowPopup is called.
+ * @param[in] showCutButton Flag to show or hide cut button, in some cases like whitespace we do not want to cut just select.
+ * default is true.
*/
- void SetUpPopUpSelection();
+ void SetUpPopupSelection( bool showCutButton = true );
/**
* Return the logical index containing the character position closest to the source.
std::size_t GetRowStartFromCharacterPosition(std::size_t logicalPosition) const;
/**
+ * Retrieves the first character of a group of characters with the same direction.
+ *
+ * @param[in] logicalPosition Index to a character.
+ *
+ * @return Index to the character.
+ */
+ std::size_t GetFirstCharacterWithSameDirection( std::size_t logicalPosition ) const;
+
+ /**
* Retrieve the dimensions of this row of text that the character resides on.
* @param[in] characterPosition the position in the 'string' of characters.
* @return The size of the rectangle representing this row
/**
* Hide highlight shown between selection handles.
+ * @param[in] hidePopup flag to hide the popup too, default is to hide popup.
*/
- void RemoveHighlight();
+ void RemoveHighlight( bool hidePopup = true );
/**
* Highlights text that has been selected
void GetTextLayoutInfo();
/**
+ * Set the offset for positioning Popup from the TextInput
+ * @param[in] offset in the order, left, top, right, bottom
+ */
+ void SetOffsetFromText( const Vector4& offset );
+
+ /**
+ * Get the offset of the Popup from the TextInput
+ * @return Vector4 with the offset in the order, left, top, right, bottom
+ */
+ const Vector4& GetOffsetFromText() const;
+
+ /**
+ * Show the Placeholder text with an already created StyleTextArray
+ * @param[in] stylePlaceHolderText Required placeholder text to be used
+ */
+ void ShowPlaceholderText( const MarkupProcessor::StyledTextArray& stylePlaceHolderText );
+
+ // Properties
+
+ /**
+ * Called when a property of an object of this type is set.
+ * @param[in] object The object whose property is set.
+ * @param[in] index The property index.
+ * @param[in] value The new property value.
+ */
+ static void SetProperty( BaseObject* object, Property::Index index, const Property::Value& value );
+
+ /**
+ * Called to retrieve a property of an object of this type.
+ * @param[in] object The object whose property is to be retrieved.
+ * @param[in] index The property index.
+ * @return The current value of the property.
+ */
+ static Property::Value GetProperty( BaseObject* object, Property::Index propertyIndex );
+
+ /**
* Emits the style changed signal.
*/
void EmitStyleChangedSignal();
/**
+ * Emit signal when text is modified.
+ */
+ void EmitTextModified();
+
+ /**
* Emits max input characters reached signal.
*/
void EmitMaxInputCharactersReachedSignal();
///< the text size after layout and the scroll offset.
MarkupProcessor::StyledTextArray mCurrentCopySelecton; ///< Array to store copied text.
- TextInputPopup mPopUpPanel; ///< Panel to house cut and paste, select all buttons.
+ TextInputPopup mPopupPanel; ///< Panel to house cut and paste, select all buttons.
Timer mScrollTimer;
Vector2 mScrollDisplacement;
Vector4 mSelectionHandleFlipMargin;
Vector4 mBoundingRectangleWorldCoordinates;
- Clipboard mClipboard; ///< Handle to clipboard
+ Clipboard mClipboard; ///< Handle to clipboard
+
+ // Styling
+ Vector4 mMaterialColor; // Color of the highlight
+ Vector4 mPopupOffsetFromText; // Offset of Popup from the TextInput.
bool mOverrideAutomaticAlignment:1; ///< Whether to override the alignment automatically set by the text content (e.g. european LTR or arabic RTL)
bool mCursorRTLEnabled:1; ///< Enable state of Alternate RTL Cursor (need to keep track of this as it's not always enabled)
Toolkit::TextInput::InputSignalV2 mInputStartedSignalV2; ///< Signal emitted when input starts
Toolkit::TextInput::InputSignalV2 mInputFinishedSignalV2; ///< Signal emitted when input ends
Toolkit::TextInput::StyleChangedSignalV2 mStyleChangedSignalV2; ///< Signal emitted when style changes.
+ Toolkit::TextInput::TextModifiedSignalType mTextModifiedSignal; ///< Signal emitted when text modified.
Toolkit::TextInput::MaxInputCharactersReachedSignalV2 mMaxInputCharactersReachedSignalV2; ///< Signal emitted when max input characters is reached.
Toolkit::TextInput::InputSignalV2 mCutAndPasteToolBarDisplayedV2; ///< Signal emitted when toolbar displayed
Toolkit::TextInput::InputTextExceedBoundariesSignalV2 mInputTextExceedBoundariesSignalV2; ///< Signal emitted when input text exceeds the boundaries of the text-input.