Button

- Main Page
- Related Pages
- Data Structures
- Files
- Examples

Functions
Button

## Functions
Evas_Object * | elm_button_add (Evas_Object *parent)
| Add a new button to the parent's canvas. More...

## Detailed Description

This is a push-button. Press it and run some function. It can contain a simple label and icon object and it also has an autorepeat feature.

This widget inherits from the Layout one, so that all the functions acting on it also work for button objects.

This widget emits the following signals, besides the ones sent from Layout:

- "clicked": the user clicked the button (press/release).
- "repeated": the user pressed the button without releasing it.
- "pressed": button was pressed.
- "unpressed": button was released after being pressed.
- `"focused"` : When the button has received focus. (since 1.8)
- `"unfocused"` : When the button has lost focus. (since 1.8) In all cases, the `event` parameter of the callback will be `NULL`.

Also, defined in the default theme, the button has the following styles available:

- default: a normal button.
- anchor: Like default, but the button fades away when the mouse is not over it, leaving only the text or icon.
- hoversel_vertical: Internally used by Hoversel to give a continuous look across its options.
- hoversel_vertical_entry: Another internal for Hoversel.
- naviframe: Internally used by Naviframe for its back button.
- colorselector: Internally used by Colorselector for its left and right buttons.

Default content parts of the button widget that you can use for are:

- "icon" - An icon of the button

Default text parts of the button widget that you can use for are:

- "default" - A label of the button

Supported elm_object common APIs.

- elm_object_part_text_set
- elm_object_part_text_get
- elm_object_part_content_set
- elm_object_part_content_get
- elm_object_part_content_unset
- elm_object_signal_emit
- elm_object_signal_callback_add
- elm_object_signal_callback_del

Here is some sample code using it:

- Button - Hello, Button!
- Button - Complete example

## Function Documentation

Evas_Object* elm_button_add | ( | Evas_Object * | parent | ) |

Add a new button to the parent's canvas.

Parameters

  parent | The parent object

Returns
  The new object or NULL if it cannot be created

Referenced by elm_color_class_editor_add(), and elm_quicklaunch_seed().