dali-toolkit/internal/controls/popup/popup-impl.h

   1 #ifndef __DALI_TOOLKIT_INTERNAL_POPUP_H__
   2 #define __DALI_TOOLKIT_INTERNAL_POPUP_H__
   3
   4 //
   5 // Copyright (c) 2014 Samsung Electronics Co., Ltd.
   6 //
   7 // Licensed under the Flora License, Version 1.0 (the License);
   8 // you may not use this file except in compliance with the License.
   9 // You may obtain a copy of the License at
  10 //
  11 //     http://floralicense.org/license/
  12 //
  13 // Unless required by applicable law or agreed to in writing, software
  14 // distributed under the License is distributed on an AS IS BASIS,
  15 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16 // See the License for the specific language governing permissions and
  17 // limitations under the License.
  18 //
  19
  20 // INTERNAL INCLUDES
  21 #include <dali/dali.h>
  22 #include <dali-toolkit/public-api/controls/control-impl.h>
  23 #include <dali-toolkit/public-api/controls/popup/popup.h>
  24 #include <dali-toolkit/internal/controls/popup/popup-style-impl.h>
  25
  26 namespace Dali
  27 {
  28
  29 namespace Toolkit
  30 {
  31
  32 class Button;
  33
  34 namespace Internal
  35 {
  36
  37 class Popup;
  38 class PopupStyle;
  39
  40 typedef IntrusivePtr<Popup>    PopupPtr;
  41 typedef IntrusivePtr<PopupStyle> PopupStylePtr;
  42
  43 /**
  44  * @copydoc Toolkit::Popup
  45  */
  46 class Popup : public ControlImpl
  47 {
  48 public:
  49
  50   /**
  51    * Create a new Popup.
  52    * @return A public handle to the newly allocated Popup.
  53    */
  54   static Dali::Toolkit::Popup New();
  55
  56 public:
  57
  58   /**
  59    * Returns number of buttons added to Popup
  60    *
  61    * @return Number of buttons
  62    */
  63   size_t GetButtonCount() const;
  64
  65   /**
  66    * @copydoc Toolkit::Popup::SetBackgroundImage
  67    */
  68   void SetBackgroundImage( Actor image );
  69
  70   /**
  71    * @copydoc Toolkit::Popup::SetButtonAreaImage
  72    */
  73   void SetButtonAreaImage( Actor image );
  74
  75   /**
  76    * @copydoc Toolkit::Popup::SetTitle( const std::string& text );
  77    */
  78   void SetTitle( const std::string& text );
  79
  80   /**
  81    * @copydoc Toolkit::Popup::SetTitle( TextView titleActor )
  82    */
  83   void SetTitle( Toolkit::TextView titleActor );
  84
  85   /**
  86    * @copydoc Toolkit::Popup::GetTitle
  87    */
  88   Toolkit::TextView GetTitle() const;
  89
  90   /**
  91    * @copydoc Toolkit::Popup::AddButton
  92    */
  93   void AddButton( Toolkit::Button button );
  94
  95   /**
  96    * @copydoc Toolkit::Popup::SetState( PopupState state )
  97    */
  98   void SetState( Toolkit::Popup::PopupState state );
  99
 100   /**
 101    * @copydoc Toolkit::Popup::SetState( PopupState state, float duration )
 102    */
 103   void SetState( Toolkit::Popup::PopupState state, float duration );
 104
 105   /**
 106    * @copydoc Toolkit::Popup::GetState( )
 107    */
 108   Toolkit::Popup::PopupState GetState() const;
 109
 110   /**
 111    * @copydoc Toolkit::Popup::ShowTail
 112    */
 113   void ShowTail(const Vector3& position);
 114
 115   /**
 116    * @copydoc Toolkit::Popup::HideTail
 117    */
 118   void HideTail();
 119
 120
 121   /**
 122    * Sets the style of the popup
 123    * @param[in] style The style of the popup
 124    */
 125   void SetStyle(PopupStyle& style);
 126
 127   /**
 128    * Gets the style of the popup
 129    * @return style of the popup
 130    */
 131   PopupStylePtr GetStyle() const;
 132
 133 protected:
 134
 135   /**
 136    * Construct a new Popup.
 137    * @param[in] style of the popup
 138    */
 139   Popup(PopupStyle& style);
 140
 141   /**
 142    * A reference counted object may only be deleted by calling Unreference()
 143    */
 144   virtual ~Popup();
 145
 146 private:
 147
 148   /**
 149    * Creates and applies the default background image.
 150    */
 151   void SetDefaultBackgroundImage();
 152
 153   /**
 154    * Create Dim Backing
 155    * (covers all content behind the dialog)
 156    */
 157   void CreateBacking();
 158
 159   /**
 160    * Create Dialog
 161    * (dialog content resides inside this - buttons, title etc.)
 162    */
 163   void CreateDialog();
 164
 165   /**
 166    * Animate Popup by scaling uniformally from 0 to 100% and vice versa (default behaviour)
 167    * @param[in] state The desired state to change into.
 168    * @param[in] duration The time for this animation to take.
 169    */
 170   void HandleStateChange( Toolkit::Popup::PopupState state, float duration );
 171
 172   /**
 173    * Invoked once StateChange has completed.
 174    */
 175   void HandleStateChangeComplete();
 176
 177 public: // Signals
 178
 179   /**
 180    * @copydoc Dali::Toolkit::Popup::OutsideTouchedSignal()
 181    */
 182   Toolkit::Popup::TouchedOutsideSignalV2& OutsideTouchedSignal();
 183
 184   /**
 185    * @copydoc Dali::Toolkit::Popup::HiddenSignal()
 186    */
 187   Toolkit::Popup::HiddenSignalV2& HiddenSignal();
 188
 189   /**
 190    * Connects a callback function with the object's signals.
 191    * @param[in] object The object providing the signal.
 192    * @param[in] tracker Used to disconnect the signal.
 193    * @param[in] signalName The signal to connect to.
 194    * @param[in] functor A newly allocated FunctorDelegate.
 195    * @return True if the signal was connected.
 196    * @post If a signal was connected, ownership of functor was passed to CallbackBase. Otherwise the caller is responsible for deleting the unused functor.
 197    */
 198   static bool DoConnectSignal( BaseObject* object, ConnectionTrackerInterface* tracker, const std::string& signalName, FunctorDelegate* functor );
 199
 200 private:
 201
 202   /**
 203    * Signal occurs when the State animation (transition from hide<->show) finishes
 204    * @param[in] source The animation that just finished.
 205    */
 206   void OnStateAnimationFinished( Animation& source );
 207
 208   /**
 209    * Signal occurs when the dimmed backing for the Popup is touched.
 210    * @param[in] actor The Actor Touched
 211    * @param[in] event The Touch Event.
 212    * @return Whether to consume event or not.
 213    */
 214   bool OnBackingTouched(Actor actor, const TouchEvent& event);
 215
 216   /**
 217    * Signal occurs when the mouse wheel event is occured on dimmed backing for the Popup.
 218    * @param[in] actor The Actor got mouse wheel
 219    * @param[in] event The Mouse Wheel Event.
 220    * @return Whether to consume event or not.
 221    */
 222   bool OnBackingMouseWheelEvent(Actor actor, const MouseWheelEvent& event);
 223
 224   /**
 225    * Signal occurs when the dialog has been touched.
 226    * @param[in] actor The Actor Touched
 227    * @param[in] event The Touch Event.
 228    * @return Whether to consume event or not.
 229    */
 230   bool OnDialogTouched(Actor actor, const TouchEvent& event);
 231
 232   /**
 233    * @copydoc Toolkit::Control::OnInitialize()
 234    */
 235   virtual void OnInitialize();
 236
 237   /**
 238    * @copydoc Dali::CustomActorImpl::OnPropertySet()
 239    */
 240   virtual void OnPropertySet( Property::Index index, Property::Value propertyValue );
 241
 242   /**
 243    * From ControlImpl; called after a child has been added to the owning actor.
 244    * @param[in] child The child which has been added.
 245    */
 246   virtual void OnControlChildAdd( Actor& child );
 247
 248   /**
 249    * @copydoc Toolkit::ControlImpl::OnRelaidOut()
 250    */
 251   virtual void OnRelaidOut( Vector2 size, ActorSizeContainer& container );
 252
 253   /**
 254    * @copydoc Toolkit::ControlImpl::OnKeyEvent()
 255    */
 256   virtual bool OnKeyEvent(const KeyEvent& event);
 257
 258   /**
 259    * @copydoc Control::GetNaturalSize()
 260    */
 261   virtual Vector3 GetNaturalSize();
 262
 263   /**
 264    * @copydoc Control::GetHeightForWidth()
 265    */
 266   float GetHeightForWidth( float width );
 267
 268   /**
 269    * @copydoc Control::GetWidthForHeight()
 270    */
 271   float GetWidthForHeight( float height );
 272
 273   /**
 274    * @copydoc Control::GetNextKeyboardFocusableActor()
 275    */
 276   Actor GetNextKeyboardFocusableActor(Actor currentFocusedActor, Control::KeyboardFocusNavigationDirection direction, bool loopEnabled);
 277
 278 private:
 279
 280   // Undefined
 281   Popup(const Popup&);
 282
 283   // Undefined
 284   Popup& operator=(const Popup& rhs);
 285
 286 private:
 287
 288   struct LayoutInfo
 289   {
 290     Vector3 mTitleSize;
 291     Vector3 mContentSize;
 292     Vector3 mButtonBgSize;
 293     std::vector<Vector3> mButtonSize;
 294   };
 295
 296 private:
 297
 298   bool mShowing;                          ///< Popup is showing or not
 299
 300   Layer mLayer;                           ///< Popup Layer (i.e. Dim backing and PopupBg reside in this)
 301   Actor mPopupBg;                         ///< Popup Background (i.e. dialog reside in this)
 302   ImageActor mBacking;                    ///< Backing actor (dim effect)
 303
 304   Actor mPreviousFocusedActor;            ///< Store the previous focused actor to restore the focus when popup hide
 305
 306   Actor mBackgroundImage;                 ///< Stores the background image.
 307   Actor mButtonAreaImage;                 ///< Stores the button background image.
 308   Toolkit::TextView mTitle;               ///< Stores the text title.
 309   Actor mContent;                         ///< Stores popup's content.
 310   Actor mBottomBg;                        ///< bottom button bar background. ImageActor is replaced with Actor due to hidden image.
 311   Actor mTailImage;                       ///< Stores the tail image
 312
 313   ActorContainer mButtons;                ///< Keeps track of the buttons added to this popup.
 314   Toolkit::Popup::PopupState mState;      ///< Popup current state.
 315   Animation mAnimation;                   ///< The animation instance managing state changing.
 316   bool mAlterAddedChild;                  ///< Flag used to control whether children are reparented or not.
 317   PopupStylePtr mPopupStyle;              ///< The style to be used for this popup.
 318
 319   LayoutInfo mLayoutInfo;                 ///< Stores sizes of all popup components.
 320
 321   Toolkit::Popup::TouchedOutsideSignalV2 mTouchedOutsideSignalV2;
 322   Toolkit::Popup::HiddenSignalV2 mHiddenSignalV2;
 323
 324   Property::Index mPropertyTitle;         ///< Property index for Title.
 325   Property::Index mPropertyState;         ///< Property index for popup state.
 326 };
 327
 328 } // namespace Internal
 329
 330 // Helpers for public-api forwarding methods
 331
 332 inline Toolkit::Internal::Popup& GetImpl(Toolkit::Popup& pub)
 333 {
 334   DALI_ASSERT_ALWAYS(pub);
 335
 336   Dali::RefObject& handle = pub.GetImplementation();
 337
 338   return static_cast<Toolkit::Internal::Popup&>(handle);
 339 }
 340
 341 inline const Toolkit::Internal::Popup& GetImpl(const Toolkit::Popup& pub)
 342 {
 343   DALI_ASSERT_ALWAYS(pub);
 344
 345   const Dali::RefObject& handle = pub.GetImplementation();
 346
 347   return static_cast<const Toolkit::Internal::Popup&>(handle);
 348 }
 349
 350 } // namespace Toolkit
 351
 352 } // namespace Dali
 353
 354 #endif // __DALI_TOOLKIT_INTERNAL_POPUP_H__