| Mx Toolkit Reference Manual | ||||
|---|---|---|---|---|
MxButton;
ClutterActor* mx_button_new (void);
ClutterActor* mx_button_new_with_label (const gchar *text);
const gchar* mx_button_get_label (MxButton *button);
void mx_button_set_label (MxButton *button,
const gchar *text);
void mx_button_set_is_toggle (MxButton *button,
gboolean toggle);
gboolean mx_button_get_is_toggle (MxButton *button);
void mx_button_set_toggled (MxButton *button,
gboolean toggled);
gboolean mx_button_get_toggled (MxButton *button);
GObject
+----GInitiallyUnowned
+----ClutterActor
+----MxWidget
+----MxBin
+----MxButton
MxButton implements ClutterScriptable, MxStylable, MxFocusable and ClutterContainer.
"is-toggle" gboolean : Read / Write "label" gchar* : Read / Write "toggled" gboolean : Read / Write
A button widget with support for either a text label or icon, toggle mode and transitions effects between states.
typedef struct _MxButton MxButton;
The contents of this structure is private and should only be accessed using the provided API.
ClutterActor* mx_button_new_with_label (const gchar *text);
Create a new MxButton with the specified label
text : |
text to set the label to |
| Returns : | a new MxButton |
const gchar* mx_button_get_label (MxButton *button);
Get the text displayed on the button
button : |
a MxButton |
| Returns : | the text for the button. This must not be freed by the application |
void mx_button_set_label (MxButton *button, const gchar *text);
Sets the text displayed on the button
button : |
a Mxbutton |
text : |
text to set the label to |
void mx_button_set_is_toggle (MxButton *button, gboolean toggle);
Enables or disables toggle mode for the button. In toggle mode, the active state will be "toggled" when the user clicks the button.
button : |
a Mxbutton |
toggle : |
TRUE or FALSE |
gboolean mx_button_get_is_toggle (MxButton *button);
Get the toggle mode status of the button.
button : |
a MxButton |
| Returns : | TRUE if toggle mode is set, otherwise FALSE |
void mx_button_set_toggled (MxButton *button, gboolean toggled);
Sets the toggled state of the button. This is only really useful if the button has toggle-mode mode set to TRUE.
button : |
a Mxbutton |
toggled : |
TRUE or FALSE |
"is-toggle" property"is-toggle" gboolean : Read / Write
Enable or disable toggling.
Default value: FALSE
"clicked" signalvoid user_function (MxButton *button, gpointer user_data) : Run Last
Emitted when the user activates the button, either with a mouse press and release or with the keyboard.
button : |
the object that received the signal |
user_data : |
user data set when the signal handler was connected. |