X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=dali-toolkit%2Finternal%2Fcontrols%2Ftext-controls%2Ftext-field-impl.h;h=5be5ba74bcfb4ec7bb6aebc5440ca3d08b9b7658;hb=23b11d5e9e206a703616aeef9bea3f75647a54db;hp=3dbec596753199935647195f9e1847822b90ab72;hpb=8363c13a95006c0cbfe3074e9b601bdaef9537f5;p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git diff --git a/dali-toolkit/internal/controls/text-controls/text-field-impl.h b/dali-toolkit/internal/controls/text-controls/text-field-impl.h index 3dbec59..5be5ba7 100644 --- a/dali-toolkit/internal/controls/text-controls/text-field-impl.h +++ b/dali-toolkit/internal/controls/text-controls/text-field-impl.h @@ -1,8 +1,8 @@ -#ifndef __DALI_TOOLKIT_INTERNAL_TEXT_LABEL_H__ -#define __DALI_TOOLKIT_INTERNAL_TEXT_LABEL_H__ +#ifndef DALI_TOOLKIT_INTERNAL_TEXT_FIELD_H +#define DALI_TOOLKIT_INTERNAL_TEXT_FIELD_H /* - * Copyright (c) 2015 Samsung Electronics Co., Ltd. + * Copyright (c) 2016 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. @@ -21,8 +21,14 @@ // INTERNAL INCLUDES #include #include -#include -#include +#include +#include +#include +#include +#include + +// EXTERNAL INCLUDES +#include namespace Dali { @@ -36,31 +42,20 @@ namespace Internal /** * @brief A control which renders a short text string. */ -class TextField : public Control +class TextField : public Control, public Text::ControlInterface, public Text::EditableControlInterface { public: - // Properties - enum - { - TEXTFIELD_PROPERTY_START_INDEX = Control::CONTROL_PROPERTY_END_INDEX + 1, - TEXTFIELD_PROPERTY_END_INDEX = TEXTFIELD_PROPERTY_START_INDEX + 1000 ///< Reserving 1000 property indices - }; - /** * @copydoc Dali::Toollkit::TextField::New() */ static Toolkit::TextField New(); - /** - * @copydoc Dali::Toollkit::TextField::SetRenderer() - */ - void SetRenderer( Text::RendererPtr renderer ); - // Properties /** - * Called when a property of an object of this type is set. + * @brief 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. @@ -68,13 +63,40 @@ public: static void SetProperty( BaseObject* object, Property::Index index, const Property::Value& value ); /** - * Called to retrieve a property of an object of this type. + * @brief 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 index ); + /** + * Connects a callback function with the object's signals. + * @param[in] object The object providing the signal. + * @param[in] tracker Used to disconnect the signal. + * @param[in] signalName The signal to connect to. + * @param[in] functor A newly allocated FunctorDelegate. + * @return True if the signal was connected. + * @post If a signal was connected, ownership of functor was passed to CallbackBase. Otherwise the caller is responsible for deleting the unused functor. + */ + static bool DoConnectSignal( BaseObject* object, ConnectionTrackerInterface* tracker, const std::string& signalName, FunctorDelegate* functor ); + + /** + * @copydoc TextField::TextChangedSignal() + */ + Toolkit::TextField::TextChangedSignalType& TextChangedSignal(); + + /** + * @copydoc TextField::MaxLengthReachedSignal() + */ + Toolkit::TextField::MaxLengthReachedSignalType& MaxLengthReachedSignal(); + + /** + * @copydoc TextField::TextChangedSignal() + */ + Toolkit::TextField::InputStyleChangedSignalType& InputStyleChangedSignal(); + private: // From Control /** @@ -83,17 +105,136 @@ private: // From Control virtual void OnInitialize(); /** + * @copydoc Control::OnStyleChange() + */ + virtual void OnStyleChange( Toolkit::StyleManager styleManager, StyleChange::Type change ); + + /** + * @copydoc Control::GetNaturalSize() + */ + virtual Vector3 GetNaturalSize(); + + /** + * @copydoc Control::GetHeightForWidth() + */ + virtual float GetHeightForWidth( float width ); + + /** * @copydoc Control::OnInitialize() */ - virtual void OnRelayout( const Vector2& size, ActorSizeContainer& container ); + virtual void OnRelayout( const Vector2& size, RelayoutContainer& container ); + + /** + * @copydoc Control::OnKeyInputFocusGained() + */ + virtual void OnKeyInputFocusGained(); + + /** + * @copydoc Control::OnKeyInputFocusLost() + */ + virtual void OnKeyInputFocusLost(); + + /** + * @copydoc Control::OnTap() + */ + virtual void OnTap( const TapGesture& tap ); + + /** + * @copydoc Control::OnPan() + */ + virtual void OnPan( const PanGesture& gesture ); + + /** + * @copydoc Control::OnLongPress() + */ + virtual void OnLongPress( const LongPressGesture& gesture ); + + /** + * @copydoc Control::OnStageConnection() + */ + virtual void OnStageConnection( int depth ); + + /** + * @copydoc Dali::CustomActorImpl::OnKeyEvent(const KeyEvent&) + */ + virtual bool OnKeyEvent(const KeyEvent& event); + +// From ControlInterface + + /** + * @copydoc Text::ControlInterface::RequestTextRelayout() + */ + virtual void RequestTextRelayout(); + +// From EditableControlInterface + + /** + * @copydoc Text::ControlInterface::TextChanged() + */ + virtual void TextChanged(); + + /** + * @copydoc Text::ControlInterface::MaxLengthReached() + */ + virtual void MaxLengthReached(); + + /** + * @copydoc Text::ControlInterface::InputStyleChanged() + */ + virtual void InputStyleChanged( Text::InputStyle::Mask inputStyleMask ); + + /** + * @copydoc Text::ControlInterface::AddDecoration() + */ + virtual void AddDecoration( Actor& actor, bool needsClipping ); private: // Implementation /** - * Helper for SetProperty. - * @param[in] text The new "text" property value. + * @copydoc Dali::Toolkit::Text::Controller::(ImfManager& imfManager, const ImfManager::ImfEventData& imfEvent) */ - void SetText( const std::string& text ); + ImfManager::ImfCallbackData OnImfEvent( ImfManager& imfManager, const ImfManager::ImfEventData& imfEvent ); + + /** + * @brief Callback when Clipboard signals an item should be pasted + * @param[in] clipboard handle to Clipboard Event Notifier + */ + void OnClipboardTextSelected( ClipboardEventNotifier& clipboard ); + + /** + * @brief Get a Property Map for the image used for the required Handle Image + * @param[out] value the returned image property + * @param[in] handleType the type of handle + * @param[in] handleImageType the type of image for the given handleType + */ + void GetHandleImagePropertyValue( Property::Value& value, Text::HandleType handleType, Text::HandleImageType handleImageType ); + + /** + * @brief Enable or disable clipping. + */ + void EnableClipping(); + + /** + * @brief Callback when keyboard is shown/hidden. + * + * @param[in] keyboardShown True if keyboard is shown. + */ + void KeyboardStatusChanged( bool keyboardShown ); + + /** + * @brief Callback when TextField is touched + * + * @param[in] actor TextField touched + * @param[in] touch Touch information + */ + bool OnTouched( Actor actor, const TouchData& touch ); + + /** + * @brief Callbacks called on idle. + * + * If there are notifications of change of input style on the queue, Toolkit::TextField::InputStyleChangedSignal() are emitted. + */ + void OnIdleSignal(); /** * Construct a new TextField. @@ -105,37 +246,58 @@ private: // Implementation */ virtual ~TextField(); -private: - // Undefined copy constructor and assignment operators TextField(const TextField&); TextField& operator=(const TextField& rhs); + /** + * @brief Render view, create and attach actor(s) to this Text Field. + */ + void RenderText( Text::Controller::UpdateTextType updateTextType ); + + // Connection needed to re-render text, when a Text Field returns to the stage. + void OnStageConnect( Dali::Actor actor ); + private: // Data + // Signals + Toolkit::TextField::TextChangedSignalType mTextChangedSignal; + Toolkit::TextField::MaxLengthReachedSignalType mMaxLengthReachedSignal; + Toolkit::TextField::InputStyleChangedSignalType mInputStyleChangedSignal; + Text::ControllerPtr mController; Text::RendererPtr mRenderer; Text::DecoratorPtr mDecorator; + Toolkit::Control mStencil; ///< For EXCEED_POLICY_CLIP + std::vector mClippingDecorationActors; ///< Decoration actors which need clipping. + + Actor mRenderableActor; + CallbackBase* mIdleCallback; + + float mAlignmentOffset; + int mRenderingBackend; + int mExceedPolicy; + bool mHasBeenStaged:1; }; } // namespace Internal // Helpers for public-api forwarding methods -inline Toolkit::Internal::TextField& GetImpl( Toolkit::TextField& textLabel ) +inline Toolkit::Internal::TextField& GetImpl( Toolkit::TextField& textField ) { - DALI_ASSERT_ALWAYS(textLabel); + DALI_ASSERT_ALWAYS(textField); - Dali::RefObject& handle = textLabel.GetImplementation(); + Dali::RefObject& handle = textField.GetImplementation(); return static_cast(handle); } -inline const Toolkit::Internal::TextField& GetImpl( const Toolkit::TextField& textLabel ) +inline const Toolkit::Internal::TextField& GetImpl( const Toolkit::TextField& textField ) { - DALI_ASSERT_ALWAYS(textLabel); + DALI_ASSERT_ALWAYS(textField); - const Dali::RefObject& handle = textLabel.GetImplementation(); + const Dali::RefObject& handle = textField.GetImplementation(); return static_cast(handle); } @@ -144,4 +306,4 @@ inline const Toolkit::Internal::TextField& GetImpl( const Toolkit::TextField& te } // namespace Dali -#endif // __DALI_TOOLKIT_INTERNAL_TEXT_LABEL_H__ +#endif // DALI_TOOLKIT_INTERNAL_TEXT_FIELD_H