Macros
#define	ELM_SEGMENT_CONTROL_CLASS elm_segment_control_class_get()
	Elementary segment control class.

#define	ELM_SEGMENT_CONTROL_EVENT_CHANGED (&(_ELM_SEGMENT_CONTROL_EVENT_CHANGED))
	Called when segment control changed. More...

Functions
EOAPI int	elm_obj_segment_control_item_count_get (const Eo *obj)
	Get the Segment items count from segment control. More...

EOAPI Elm_Widget_Item *	elm_obj_segment_control_item_selected_get (const Eo *obj)
	Get the selected item. More...

EOAPI const char *	elm_obj_segment_control_item_label_get (const Eo *obj, int idx)
	Get the label of item. More...

EOAPI Elm_Widget_Item *	elm_obj_segment_control_item_insert_at (Eo obj, Efl_Canvas_Object icon, const char *label, int idx)
	Insert a new item to the segment control object at specified position. More...

EOAPI Elm_Widget_Item *	elm_obj_segment_control_item_get (const Eo *obj, int idx)
	Get the item placed at specified index. More...

EOAPI void	elm_obj_segment_control_item_del_at (Eo *obj, int idx)
	Remove a segment control item at given index from its parent, deleting it. More...

EOAPI Elm_Widget_Item *	elm_obj_segment_control_item_add (Eo obj, Efl_Canvas_Object icon, const char *label)
	Append a new item to the segment control object. More...

EOAPI Efl_Canvas_Object *	elm_obj_segment_control_item_icon_get (const Eo *obj, int idx)
	Get the icon associated to the item. More...

Evas_Object *	elm_segment_control_add (Evas_Object *parent)
	Add a new segment control widget to the given parent Elementary (container) object. More...

Detailed Description

Segment control widget is a horizontal control made of multiple segment items, each segment item functioning similar to discrete two state button. A segment control groups the items together and provides compact single button with multiple equal size segments.

Segment item size is determined by base widget size and the number of items added. Only one segment item can be at selected state. A segment item can display combination of Text and any Evas_Object like Images or other widget.

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

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

"changed" - When the user clicks on a segment item which is not previously selected and get selected. The event_info parameter is the segment item pointer.
"language,changed" - the program's language changed (since 1.9)

Available styles for it:

"default"

Default content parts of the segment control items that you can use for are:

"icon" - An icon in a segment control item

Default text parts of the segment control items that you can use for are:

"default" - A title label in a segment control item

Supported elm_object common APIs.

elm_object_disabled_set
elm_object_disabled_get

Supported elm_object_item common APIs.

Here is an example on its usage:

Segment Control Example

Macro Definition Documentation

◆ ELM_SEGMENT_CONTROL_EVENT_CHANGED

#define ELM_SEGMENT_CONTROL_EVENT_CHANGED (&(_ELM_SEGMENT_CONTROL_EVENT_CHANGED))

Called when segment control changed.

Returns: Efl_Object *

Function Documentation

◆ elm_obj_segment_control_item_count_get()

EOAPI int elm_obj_segment_control_item_count_get ( const Eo * obj )

Get the Segment items count from segment control.

It will just return the number of items added to segment control obj.

Parameters

[in] obj The object.

Returns: Segment items count.

◆ elm_obj_segment_control_item_selected_get()

EOAPI Elm_Widget_Item * elm_obj_segment_control_item_selected_get ( const Eo * obj )

Get the selected item.

The selected item can be unselected with function elm_segment_control_item_selected_set().

The selected item always will be highlighted on segment control.

Parameters

[in] obj The object.

Returns: The selected item or NULL if none of segment items is selected.

◆ elm_obj_segment_control_item_label_get()

EOAPI const char * elm_obj_segment_control_item_label_get	(	const Eo *	obj,
		int	idx
	)

Get the label of item.

The return value is a pointer to the label associated to the item when it was created, with function elm_segment_control_item_add(), or later with function elm_object_item_text_set. If no label was passed as argument, it will return NULL.

Parameters

[in]	obj	The object.
[in]	idx	The index of the segment item.

Returns: The label of the item at index.

◆ elm_obj_segment_control_item_insert_at()

EOAPI Elm_Widget_Item * elm_obj_segment_control_item_insert_at	(	Eo *	obj,
		Efl_Canvas_Object *	icon,
		const char *	label,
		int	idx
	)

Insert a new item to the segment control object at specified position.

Index values must be between $0, when item will be prepended to segment control, and items count, that can be get with elm_segment_control_item_count_get(), case when item will be appended to segment control, just like elm_segment_control_item_add().

Items created with this function can be deleted with function elm_object_item_del() or elm_segment_control_item_del_at().

Note: label set to NULL is different from empty string "". If an item only has icon, it will be displayed bigger and centered. If it has icon and label, even that an empty string, icon will be smaller and positioned at left.

Parameters

[in]	obj	The object.
[in]	icon	The icon object to use for the left side of the item. An icon can be any Evas object, but usually it is an icon created with elm_icon_add().
[in]	label	The label of the item.
[in]	idx	Item position. Value should be between 0 and items count.

Returns: The created item or NULL upon failure.

◆ elm_obj_segment_control_item_get()

EOAPI Elm_Widget_Item * elm_obj_segment_control_item_get	(	const Eo *	obj,
		int	idx
	)

Get the item placed at specified index.

Index is the position of an item in segment control widget. Its range is from $0 to count - 1 . Count is the number of items, that can be get with elm_segment_control_item_count_get().

Parameters

[in]	obj	The object.
[in]	idx	The index of the segment item.

Returns: The segment control item or NULL on failure.

◆ elm_obj_segment_control_item_del_at()

EOAPI void elm_obj_segment_control_item_del_at	(	Eo *	obj,
		int	idx
	)

Remove a segment control item at given index from its parent, deleting it.

Items can be added with elm_segment_control_item_add() or elm_segment_control_item_insert_at().

Parameters

[in]	obj	The object.
[in]	idx	The position of the segment control item to be deleted.

◆ elm_obj_segment_control_item_add()

EOAPI Elm_Widget_Item * elm_obj_segment_control_item_add	(	Eo *	obj,
		Efl_Canvas_Object *	icon,
		const char *	label
	)

Append a new item to the segment control object.

A new item will be created and appended to the segment control, i.e., will be set as last item.

If it should be inserted at another position, elm_segment_control_item_insert_at() should be used instead.

Items created with this function can be deleted with function elm_object_item_del() or elm_object_item_del_at().

Note: label set to NULL is different from empty string "". If an item only has icon, it will be displayed bigger and centered. If it has icon and label, even that an empty string, icon will be smaller and positioned at left.

Parameters

[in]	obj	The object.
[in]	icon	The icon object to use for the left side of the item. An icon can be any Evas object, but usually it is an icon created with elm_icon_add().
[in]	label	The label of the item. Note that, NULL is different from empty string "".

Returns: The created item or NULL upon failure.

◆ elm_obj_segment_control_item_icon_get()

EOAPI Efl_Canvas_Object * elm_obj_segment_control_item_icon_get	(	const Eo *	obj,
		int	idx
	)

Get the icon associated to the item.

The return value is a pointer to the icon associated to the item when it was created, with function elm_segment_control_item_add(), or later with function elm_object_item_part_content_set(). If no icon was passed as argument, it will return NULL.

Parameters

[in]	obj	The object.
[in]	idx	The index of the segment item.

Returns: The left side icon associated to the item at index.

◆ elm_segment_control_add()

Evas_Object * elm_segment_control_add ( Evas_Object * parent )

Add a new segment control widget to the given parent Elementary (container) object.

Parameters

parent The parent object.

Returns: a new segment control widget handle or NULL, on errors.

This function inserts a new segment control widget on the canvas.

References EINA_SAFETY_ON_NULL_RETURN_VAL.

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ ELM_SEGMENT_CONTROL_EVENT_CHANGED

Function Documentation

◆ elm_obj_segment_control_item_count_get()

◆ elm_obj_segment_control_item_selected_get()

◆ elm_obj_segment_control_item_label_get()

◆ elm_obj_segment_control_item_insert_at()

◆ elm_obj_segment_control_item_get()

◆ elm_obj_segment_control_item_del_at()

◆ elm_obj_segment_control_item_add()

◆ elm_obj_segment_control_item_icon_get()

◆ elm_segment_control_add()