Top | ![]() |
![]() |
![]() |
![]() |
ClutterActor * | mx_button_new () |
ClutterActor * | mx_button_new_with_label () |
const gchar * | mx_button_get_label () |
void | mx_button_set_label () |
const gchar * | mx_button_get_icon_name () |
void | mx_button_set_icon_name () |
guint | mx_button_get_icon_size () |
void | mx_button_set_icon_size () |
void | mx_button_set_is_toggle () |
gboolean | mx_button_get_is_toggle () |
void | mx_button_set_toggled () |
gboolean | mx_button_get_toggled () |
void | mx_button_set_action () |
MxAction * | mx_button_get_action () |
void | mx_button_set_icon_position () |
MxPosition | mx_button_get_icon_position () |
void | mx_button_set_icon_visible () |
gboolean | mx_button_get_icon_visible () |
void | mx_button_set_label_visible () |
gboolean | mx_button_get_label_visible () |
MxAction * | action | Read / Write |
char * | icon-name | Read / Write |
MxPosition | icon-position | Read / Write |
guint | icon-size | Read / Write |
gboolean | icon-visible | Read / Write |
gboolean | is-toggle | Read / Write |
char * | label | Read / Write |
gboolean | label-visible | Read / Write |
gboolean | toggled | Read / Write |
MxButton implements ClutterContainer, ClutterScriptable, ClutterAnimatable, AtkImplementorIface, MxStylable and MxFocusable.
A button widget with support for either a text label or icon, toggle mode and transitions effects between states.
ClutterActor *
mx_button_new_with_label (const gchar *text
);
Create a new MxButton with the specified label
const gchar *
mx_button_get_label (MxButton *button
);
Get the text displayed on the button
void mx_button_set_label (MxButton *button
,const gchar *text
);
Sets the text displayed on the button
const gchar *
mx_button_get_icon_name (MxButton *button
);
Get the icon-name being used on the button.
Since: 1.2
void mx_button_set_icon_name (MxButton *button
,const gchar *icon_name
);
Sets the icon-name used to display an icon on the button. Setting NULL
will remove the icon name, or resort to the icon-name set in the current
style. Setting an icon name overrides any icon set in the style.
Since: 1.2
guint
mx_button_get_icon_size (MxButton *button
);
Retrieves the icon-size being used for the displayed icon inside the button.
Since: 1.2
void mx_button_set_icon_size (MxButton *button
,guint icon_size
);
Sets the icon-size to use for the icon displayed inside the button. This will
override the icon-size set in the style. Setting a value of 0
resets to the
size from the style.
Since: 1.2
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.
gboolean
mx_button_get_is_toggle (MxButton *button
);
Get the toggle mode status of the button.
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.
gboolean
mx_button_get_toggled (MxButton *button
);
Get the state of the button that is in toggle mode.
void mx_button_set_action (MxButton *button
,MxAction *action
);
Sets action
as the action for button
. Button
will take its label and
icon from action
.
Since: 1.2
MxAction *
mx_button_get_action (MxButton *button
);
Retrieves the MxAction associated with button
.
Since: 1.2
void mx_button_set_icon_position (MxButton *button
,MxPosition position
);
Sets the icon position, relative to the text on the button.
Since: 1.2
MxPosition
mx_button_get_icon_position (MxButton *button
);
Retrieves the icon's relative position to the text.
Since: 1.2
void mx_button_set_icon_visible (MxButton *button
,gboolean visible
);
Sets the visibility of the icon associated with the button's action.
Since: 1.2
gboolean
mx_button_get_icon_visible (MxButton *button
);
Retrieves the visibility of the icon associated with the button's action.
Since: 1.2
void mx_button_set_label_visible (MxButton *button
,gboolean visible
);
Sets the visibility of the text associated with the button's action.
Since: 1.2
struct MxButton;
The contents of this structure is private and should only be accessed using the provided API.
“icon-name”
property “icon-name” char *
Icon name of the button.
Owner: MxButton
Flags: Read / Write
Default value: NULL
“icon-position”
property“icon-position” MxPosition
The position of the icon, relative to the text.
Owner: MxButton
Flags: Read / Write
Default value: MX_POSITION_LEFT
“icon-size”
property “icon-size” guint
The size to use for the button icon (in pixels).
Owner: MxButton
Flags: Read / Write
Default value: 0
“icon-visible”
property “icon-visible” gboolean
Whether to show the icon.
Owner: MxButton
Flags: Read / Write
Default value: TRUE
“is-toggle”
property “is-toggle” gboolean
Enable or disable toggling.
Owner: MxButton
Flags: Read / Write
Default value: FALSE
“label”
property “label” char *
Label of the button.
Owner: MxButton
Flags: Read / Write
Default value: NULL
“label-visible”
property “label-visible” gboolean
Whether to show the label.
Owner: MxButton
Flags: Read / Write
Default value: TRUE
“clicked”
signalvoid user_function (MxButton *button, gpointer user_data)
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. |
Flags: Run Last