Top | ![]() |
![]() |
![]() |
![]() |
StWidget * | st_button_new () |
StWidget * | st_button_new_with_label () |
const gchar * | st_button_get_label () |
void | st_button_set_label () |
void | st_button_set_toggle_mode () |
gboolean | st_button_get_toggle_mode () |
void | st_button_set_checked () |
gboolean | st_button_get_checked () |
void | st_button_fake_release () |
#define | ST_BUTTON_MASK_FROM_BUTTON() |
void | st_button_set_button_mask () |
StButtonMask | st_button_get_button_mask () |
A button widget with support for either a text label or icon, toggle mode and transitions effects between states.
StWidget *
st_button_new_with_label (const gchar *text
);
Create a new StButton with the specified label
const gchar *
st_button_get_label (StButton *button
);
Get the text displayed on the button. If the label is empty, an empty string
will be returned instead of NULL
.
void st_button_set_label (StButton *button
,const gchar *text
);
Sets the text displayed on the button.
void st_button_set_toggle_mode (StButton *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
st_button_get_toggle_mode (StButton *button
);
Get the toggle mode status of the button.
void st_button_set_checked (StButton *button
,gboolean checked
);
Set the “checked” property of the button. This is only really useful
if the button has “toggle-mode” property set to TRUE
.
gboolean
st_button_get_checked (StButton *button
);
Get the “checked” property of a StButton that is in toggle mode.
void
st_button_fake_release (StButton *button
);
If this widget is holding a pointer grab, this function will will ungrab it, and reset the “pressed” state. The effect is similar to if the user had released the mouse button, but without emitting the “clicked” signal.
This function is useful if for example you want to do something after the user is holding the mouse button for a given period of time, breaking the grab.
void st_button_set_button_mask (StButton *button
,StButtonMask mask
);
Sets which mouse buttons button
emits “clicked” for.
StButtonMask
st_button_get_button_mask (StButton *button
);
Gets the mask of mouse buttons that button
emits the
“clicked” signal for.
struct StButtonClass { StBinClass parent_class; /* vfuncs, not signals */ void (* transition) (StButton *button); /* signals */ void (* clicked) (StButton *button, int clicked_button); };