+/*
+ * 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.
+ * 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.
+ *
+ */
+
+#include <dali-toolkit/dali-toolkit.h>
+#include <dali-toolkit/devel-api/controls/control-devel.h>
+#include <dali-toolkit/devel-api/controls/tooltip/tooltip-properties.h>
+#include <dali-toolkit/devel-api/visuals/text-visual-properties.h>
+#include <dali-toolkit/devel-api/visuals/visual-properties-devel.h>
+
+using namespace Dali;
+using namespace Dali::Toolkit;
+
+namespace
+{
+const Vector4 STAGE_COLOR( 211.0f / 255.0f, 211.0f / 255.0f, 211.0f / 255.0f, 1.0f ); ///< The color of the stage
+const char * const THEME_PATH( DEMO_STYLE_DIR "tooltip-example-theme.json" ); ///< The theme used for this example
+const float POSITION_INCREMENTER( 0.2f ); ///< The position difference between the controls along the Y-Axis.
+} // unnamed namespace
+
+/**
+ * @brief Creates a controller which demonstrates the tooltip functionality in control.
+ *
+ * The Control base class supports tooltip functionality. However, the Toolkit Tooltip style is only set on Buttons by default.
+ * This example portrays the different ways in which a tooltip can be displayed and customised.
+ */
+class TooltipController : public ConnectionTracker
+{
+public:
+
+ TooltipController( Application& application )
+ : mApplication( application ),
+ previousPosition( 0.0f )
+ {
+ // Connect to the Application's Init signal
+ mApplication.InitSignal().Connect( this, &TooltipController::Create );
+ }
+
+private:
+
+ // The Init signal is received once (only) during the Application lifetime
+ void Create( Application& application )
+ {
+ // Hide the indicator bar
+ application.GetWindow().ShowIndicator( Dali::Window::INVISIBLE );
+
+ // Set the stage background color and connect to the stage's key signal to allow Back and Escape to exit.
+ Stage stage = Stage::GetCurrent();
+ stage.SetBackgroundColor( STAGE_COLOR );
+ stage.KeyEventSignal().Connect( this, &TooltipController::OnKeyEvent );
+ const Vector2 stageSize = stage.GetSize();
+
+ // Add a text label at the top for information purposes
+ Control label = TextLabel::New( "Hover over buttons to see tooltip" );
+ label.SetParentOrigin( ParentOrigin::TOP_CENTER );
+ label.SetAnchorPoint( AnchorPoint::TOP_CENTER );
+ label.SetProperty( TextLabel::Property::HORIZONTAL_ALIGNMENT, "Center" );
+ stage.Add( label );
+
+ // Simple tooltip from stylesheet
+ Control simple = PushButton::New();
+ simple.SetStyleName( "TooltipTextOnly" );
+ SetLabel( simple, "Simple" );
+ Layout( simple, stageSize );
+ stage.Add( simple );
+
+ // Tooltip with icon and text, from stylesheet
+ Control iconWithText = PushButton::New();
+ iconWithText.SetStyleName( "TooltipArray" );
+ SetLabel( iconWithText, "Icon with Text" );
+ Layout( iconWithText, stageSize );
+ stage.Add( iconWithText );
+
+ // Tooltip with custom style, from stylesheet
+ Control customFromStylesheet = PushButton::New();
+ customFromStylesheet.SetStyleName( "TooltipCustom" );
+ SetLabel( customFromStylesheet, "Custom From Stylesheet" );
+ Layout( customFromStylesheet, stageSize );
+ stage.Add( customFromStylesheet );
+
+ // Tooltip with custom style, from code
+ Control customFromCode = PushButton::New();
+ SetLabel( customFromCode, "Custom From Code" );
+ Layout( customFromCode, stageSize );
+ customFromCode.SetProperty( DevelControl::Property::TOOLTIP,
+ Property::Map().Add( Tooltip::Property::CONTENT,
+ Property::Array().Add( Property::Map().Add( Visual::Property::TYPE, Visual::IMAGE )
+ .Add( ImageVisual::Property::URL, DEMO_IMAGE_DIR "Logo-for-demo.png" ) )
+ .Add( Property::Map().Add( Visual::Property::TYPE, DevelVisual::TEXT )
+ .Add( TextVisual::Property::TEXT_COLOR, Color::WHITE )
+ .Add( TextVisual::Property::TEXT, "Custom coded style\nat hover point" )
+ .Add( TextVisual::Property::MULTI_LINE, true )
+ .Add( TextVisual::Property::HORIZONTAL_ALIGNMENT, "CENTER" )
+ .Add( TextVisual::Property::POINT_SIZE, 16 ) ) )
+ .Add( Tooltip::Property::LAYOUT, Vector2( 2, 1 ) )
+ .Add( Tooltip::Property::POSITION, Tooltip::Position::HOVER_POINT )
+ .Add( Tooltip::Property::BACKGROUND,
+ Property::Map().Add( Tooltip::Background::Property::VISUAL, DEMO_IMAGE_DIR "tooltip.9.png" )
+ .Add( Tooltip::Background::Property::BORDER, Rect< int >( 1, 5, 5, 1 ) ) )
+ );
+ stage.Add( customFromCode );
+ }
+
+ /**
+ * @brief Called when any key event is received
+ *
+ * Will use this to quit the application if Back or the Escape key is received
+ * @param[in] event The key event information
+ */
+ void OnKeyEvent( const KeyEvent& event )
+ {
+ if( event.state == KeyEvent::Down )
+ {
+ if ( IsKey( event, Dali::DALI_KEY_ESCAPE ) || IsKey( event, Dali::DALI_KEY_BACK ) )
+ {
+ mApplication.Quit();
+ }
+ }
+ }
+
+ /**
+ * @brief Sets the label on the control.
+ * @param[in] label The label to set.
+ */
+ void SetLabel( Control control, std::string label )
+ {
+ if( control )
+ {
+ control.SetProperty( Button::Property::LABEL,
+ Property::Map().Add( Visual::Property::TYPE, DevelVisual::TEXT )
+ .Add( TextVisual::Property::TEXT, label ) );
+ }
+ }
+
+ /**
+ * @brief Lays out the control in the appropriate location.
+ * @param[in] control The control to layout.
+ * @param[in] stageSize The size of the stage, passing it in so we don't have to retrieve it every time.
+ */
+ void Layout( Control control, const Vector2& stageSize )
+ {
+ if( control )
+ {
+ previousPosition += POSITION_INCREMENTER;
+ control.SetResizePolicy( ResizePolicy::SIZE_RELATIVE_TO_PARENT, Dimension::ALL_DIMENSIONS );
+ control.SetSizeModeFactor( Vector3( 0.75, 0.1, 1.0 ) );
+ control.SetAnchorPoint( AnchorPoint::CENTER );
+ control.SetParentOrigin( ParentOrigin::TOP_CENTER );
+ control.SetY( stageSize.height * previousPosition );
+ }
+ }
+
+private:
+ Application& mApplication;
+ float previousPosition;
+};
+
+int DALI_EXPORT_API main( int argc, char **argv )
+{
+ Application application = Application::New( &argc, &argv, THEME_PATH );
+
+ TooltipController test( application );
+
+ application.MainLoop();
+
+ return 0;
+}