X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;ds=sidebyside;f=dali-toolkit%2Fpublic-api%2Fcontrols%2Fbuttons%2Fcheck-box-button.h;h=12d14f34f3c5fb267b5488afca3bb37e05940333;hb=HEAD;hp=357c3e1e7e9c18d01b8e2cfad8d7b777fbfeb5b2;hpb=5c07fde9dd6a022e2080c871994499e56eff89aa;p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git diff --git a/dali-toolkit/public-api/controls/buttons/check-box-button.h b/dali-toolkit/public-api/controls/buttons/check-box-button.h index 357c3e1..9dafa28 100644 --- a/dali-toolkit/public-api/controls/buttons/check-box-button.h +++ b/dali-toolkit/public-api/controls/buttons/check-box-button.h @@ -1,8 +1,8 @@ -#ifndef __DALI_TOOLKIT_CHECK_BOX_BUTTON_H__ -#define __DALI_TOOLKIT_CHECK_BOX_BUTTON_H__ +#ifndef DALI_TOOLKIT_CHECK_BOX_BUTTON_H +#define DALI_TOOLKIT_CHECK_BOX_BUTTON_H /* - * Copyright (c) 2015 Samsung Electronics Co., Ltd. + * Copyright (c) 2020 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. @@ -23,10 +23,8 @@ namespace Dali { - namespace Toolkit { - // Forward declarations namespace Internal DALI_INTERNAL @@ -34,80 +32,134 @@ namespace Internal DALI_INTERNAL class CheckBoxButton; } /** - * @addtogroup dali-toolkit-controls-buttons + * @addtogroup dali_toolkit_controls_buttons * @{ */ /** - * CheckBoxButton provides a check box button which user can check or uncheck. + * @brief CheckBoxButton provides a check box button which user can check or uncheck. * - * By default a CheckBoxButton emits a Button::ClickedSignal() signal when the button changes its state to selected or unselected. + * By default, a CheckBoxButton emits a Button::ClickedSignal() signal when the button changes its state to selected or unselected. * - * The button's appearance could be modified by setting images or actors with CheckBoxButton::SetBackgroundImage, - * CheckBoxButton::SetSelectedImage, CheckBoxButton::SetDisabledBackgroundImage and CheckBoxButton::SetDisabledSelectedImage. + * The button's appearance could be modified by Button::SetUnselectedImage, Button::SetBackgroundImage, + * Button::SetSelectedImage, Button::SetSelectedBackgroundImage, Button::SetDisabledBackgroundImage, + * Button::SetDisabledImage, and Button::SetDisabledSelectedImage. * * When the button is not disabled, if it's not selected it only shows the \e background image. The \e selected image is shown over the * \e background image when the box is selected (\e background image is not replaced by \e selected image). * * When the button is disabled, \e background image and \e selected image are replaced by \e disabled images. * - * CheckBoxButton doesn't have a text. However, a Dali::Toolkit::TableView with a Dali::TextActor or a Dali::Toolkit::TextView - * and a CheckBoxButton could be used instead. + * Usage example: - + * + * @code + * // in Creating a DALi Application + * void HelloWorldExample::Create( Application& application ) + * { + * CheckBoxButton button = CheckBoxButton::New(); + * button.SetProperty( Actor::Property::PARENT_ORIGIN, ParentOrigin::CENTER ); + * button.SetProperty( Button::Property::LABEL, "Check" ); + * button.SetProperty( Actor::Property::SIZE, Vector2( 200, 40 ); + * button.SetBackgroundColor( Color::WHITE ); + * Stage::GetCurrent().Add( button ); + * + * // Connect to a button signal emitted by the button + * button.StateChangedSignal().Connect( this, &HelloWorldExample::OnButtonStateChanged ); + * } + * + * bool HelloWorldExample::OnButtonStateChanged( Button button ) + * { + * // Do something when the button state is changed + * // You can get the state using button.IsSelected() call + * return true; + * } + * @endcode + * @SINCE_1_0.0 */ -class DALI_IMPORT_API CheckBoxButton : public Button +class DALI_TOOLKIT_API CheckBoxButton : public Button { public: - /** - * Create an uninitialized CheckBoxButton; this can be initialized with CheckBoxButton::New() + * @brief Creates an uninitialized CheckBoxButton; this can be initialized with CheckBoxButton::New(). * Calling member functions with an uninitialized Dali::Object is not allowed. + * @SINCE_1_0.0 */ CheckBoxButton(); /** - * Copy constructor. + * @brief Copy constructor. + * @SINCE_1_0.0 + * @param[in] checkBox Handle to an object + */ + CheckBoxButton(const CheckBoxButton& checkBox); + + /** + * @brief Move constructor + * @SINCE_1_9.23 + * + * @param[in] rhs A reference to the moved handle + */ + CheckBoxButton(CheckBoxButton&& rhs) noexcept; + + /** + * @brief Assignment operator. + * @SINCE_1_0.0 + * @param[in] checkBox Handle to an object + * @return A reference to this */ - CheckBoxButton( const CheckBoxButton& checkBox ); + CheckBoxButton& operator=(const CheckBoxButton& checkBox); /** - * Assignment operator. + * @brief Move assignment + * @SINCE_1_9.23 + * + * @param[in] rhs A reference to the moved handle + * @return A reference to this */ - CheckBoxButton& operator=( const CheckBoxButton& checkBox ); + CheckBoxButton& operator=(CheckBoxButton&& rhs) noexcept; /** - * @brief Destructor + * @brief Destructor. * * This is non-virtual since derived Handle types must not contain data or virtual methods. + * @SINCE_1_0.0 */ ~CheckBoxButton(); /** - * Create an initialized CheckBoxButton. - * @return A handle to a newly allocated Dali resource. + * @brief Creates an initialized CheckBoxButton. + * @SINCE_1_0.0 + * @return A handle to a newly allocated Dali resource */ static CheckBoxButton New(); /** - * Downcast an Object handle to CheckBoxButton. If handle points to a CheckBoxButton the - * downcast produces valid handle. If not the returned handle is left uninitialized. + * @brief Downcasts a handle to CheckBoxButton handle. + * + * If handle points to a CheckBoxButton, the downcast produces valid handle. + * If not, the returned handle is left uninitialized. + * @SINCE_1_0.0 * @param[in] handle Handle to an object - * @return handle to a CheckBoxButton or an uninitialized handle + * @return Handle to a CheckBoxButton or an uninitialized handle */ - static CheckBoxButton DownCast( BaseHandle handle ); + static CheckBoxButton DownCast(BaseHandle handle); public: // Not intended for application developers - + /// @cond internal /** - * Creates a handle using the Toolkit::Internal implementation. - * @param[in] implementation The Control implementation. + * @brief Creates a handle using the Toolkit::Internal implementation. + * @SINCE_1_0.0 + * @param[in] implementation The Control implementation */ - DALI_INTERNAL CheckBoxButton( Internal::CheckBoxButton& implementation ); + DALI_INTERNAL CheckBoxButton(Internal::CheckBoxButton& implementation); /** - * Allows the creation of this Control from an Internal::CustomActor pointer. - * @param[in] internal A pointer to the internal CustomActor. + * @brief Allows the creation of this Control from an Internal::CustomActor pointer. + * @SINCE_1_0.0 + * @param[in] internal A pointer to the internal CustomActor */ - DALI_INTERNAL CheckBoxButton( Dali::Internal::CustomActor* internal ); + DALI_INTERNAL CheckBoxButton(Dali::Internal::CustomActor* internal); + /// @endcond }; /** @@ -117,4 +169,4 @@ public: // Not intended for application developers } // namespace Dali -#endif // __DALI_TOOLKIT_CHECK_BOX_BUTTON_H__ +#endif // DALI_TOOLKIT_CHECK_BOX_BUTTON_H