Button& operator=( const Button& button );
/**
- * @brief Downcast an Object handle to Button.
+ * @brief Downcast a handle to Button handle.
*
* If handle points to a Button 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 Button or an uninitialized handle
+ * @return A handle to a Button or an uninitialized handle
*/
static Button DownCast( BaseHandle handle );
void SetDisabled( bool disabled );
/**
+ * @brief Returns if the button is disabled.
* @SINCE_1_0.0
* @return \e true if the button is \e disabled.
*/
void SetAutoRepeating( bool autoRepeating );
/**
+ * @brief Returns if the autorepeating property is set.
* @SINCE_1_0.0
* @return \e true if the \e autorepeating property is set.
*/
void SetInitialAutoRepeatingDelay( float initialAutoRepeatingDelay );
/**
+ * @brief Gets the initial autorepeating delay in seconds.
* @SINCE_1_0.0
* @return the initial autorepeating delay in seconds.
*/
void SetNextAutoRepeatingDelay( float nextAutoRepeatingDelay );
/**
+ * @brief Gets the next autorepeating delay in seconds.
* @SINCE_1_0.0
* @return the next autorepeating delay in seconds.
*/
void SetTogglableButton( bool togglable );
/**
+ * @brief Returns if the togglable property is set.
* @SINCE_1_0.0
* @return \e true if the \e togglable property is set.
*/
void SetSelected( bool selected );
/**
+ * @brief Returns if the selected property is set and the button is togglable.
* @SINCE_1_0.0
- * @return \e true if the \e selected property is set and the button is togglable.
+ * @return \e true if the button is \e selected.
*/
bool IsSelected() const;
// Deprecated API
/**
- * @DEPRECATED_1_0.50
+ * @DEPRECATED_1_0.50. Instead, use SetLabelText.
*
* @brief Sets the label with an actor.
*
void SetLabel( Actor label );
/**
- * @DEPRECATED_1_0.50
+ * @DEPRECATED_1_0.50. Instead, use SetUnselectedImage.
*
* @brief Sets the button image.
*
void SetButtonImage( Image image );
/**
- * @DEPRECATED_1_0.50
+ * @DEPRECATED_1_0.50. Instead, use SetSelectedImage( const std::string& filename ).
*
* @brief Sets the selected image.
*
* @brief Gets the button image.
*
* @SINCE_1_0.0
+ * @remarks Avoid using this method as it's a legacy code.
* @return An actor with the button image.
*/
Actor GetButtonImage() const;
* @brief Gets the selected image.
*
* @SINCE_1_0.0
+ * @remarks Avoid using this method as it's a legacy code.
* @return An actor with the selected image.
*/
Actor GetSelectedImage() const;
/**
* @brief This signal is emitted when the button's state is changed.
+ *
* The application can get the state by calling IsSelected().
*
* A callback of the following type may be connected: