Macros | Enumerations | Functions

The Bubble is a widget to show text similar to how speech is represented in comics. More...

Macros

#define ELM_BUBBLE_CLASS   elm_bubble_class_get()
 Speech bubble widget used in messaging applications.
 

Enumerations

enum  Elm_Bubble_Pos {
  ELM_BUBBLE_POS_INVALID = -1,
  ELM_BUBBLE_POS_TOP_LEFT,
  ELM_BUBBLE_POS_TOP_RIGHT,
  ELM_BUBBLE_POS_BOTTOM_LEFT,
  ELM_BUBBLE_POS_BOTTOM_RIGHT,
  ELM_BUBBLE_POS_INVALID = -1,
  ELM_BUBBLE_POS_TOP_LEFT,
  ELM_BUBBLE_POS_TOP_RIGHT,
  ELM_BUBBLE_POS_BOTTOM_LEFT,
  ELM_BUBBLE_POS_BOTTOM_RIGHT
}
 Defines the corner values for a bubble. More...
 
enum  Elm_Bubble_Pos {
  ELM_BUBBLE_POS_INVALID = -1,
  ELM_BUBBLE_POS_TOP_LEFT,
  ELM_BUBBLE_POS_TOP_RIGHT,
  ELM_BUBBLE_POS_BOTTOM_LEFT,
  ELM_BUBBLE_POS_BOTTOM_RIGHT,
  ELM_BUBBLE_POS_INVALID = -1,
  ELM_BUBBLE_POS_TOP_LEFT,
  ELM_BUBBLE_POS_TOP_RIGHT,
  ELM_BUBBLE_POS_BOTTOM_LEFT,
  ELM_BUBBLE_POS_BOTTOM_RIGHT
}
 Defines the corner values for a bubble. More...
 

Functions

EOAPI void elm_obj_bubble_pos_set (Eo *obj, Elm_Bubble_Pos pos)
 The corner of the bubble. More...
 
EOAPI Elm_Bubble_Pos elm_obj_bubble_pos_get (const Eo *obj)
 The corner of the bubble. More...
 
Evas_Objectelm_bubble_add (Evas_Object *parent)
 Add a new bubble to the parent. More...
 

Detailed Description

The Bubble is a widget to show text similar to how speech is represented in comics.

bubble_inheritance_tree.png
preview-00.png
preview-01.png
preview-02.png

The bubble widget contains 5 important visual elements:

The position of the arrow, icon, label and info depends on which corner is selected. The four available corners are:

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

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

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

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

Supported elm_object common APIs.

For an example of using a bubble see this.

Enumeration Type Documentation

◆ Elm_Bubble_Pos [1/2]

Defines the corner values for a bubble.

The corner will be used to determine where the arrow of the bubble points to.

Enumerator
ELM_BUBBLE_POS_INVALID 

Invalid corner.

ELM_BUBBLE_POS_TOP_LEFT 

The arrow of the bubble points to the top left corner.

ELM_BUBBLE_POS_TOP_RIGHT 

The arrow of the bubble points to the top right corner.

ELM_BUBBLE_POS_BOTTOM_LEFT 

The arrow of the bubble points to the bottom left corner.

ELM_BUBBLE_POS_BOTTOM_RIGHT 

The arrow of the bubble points to the bottom right corner.

ELM_BUBBLE_POS_INVALID 

Invalid corner.

ELM_BUBBLE_POS_TOP_LEFT 

The arrow of the bubble points to the top left corner.

ELM_BUBBLE_POS_TOP_RIGHT 

The arrow of the bubble points to the top right corner.

ELM_BUBBLE_POS_BOTTOM_LEFT 

The arrow of the bubble points to the bottom left corner.

ELM_BUBBLE_POS_BOTTOM_RIGHT 

The arrow of the bubble points to the bottom right corner.

◆ Elm_Bubble_Pos [2/2]

Defines the corner values for a bubble.

The corner will be used to determine where the arrow of the bubble points to.

Enumerator
ELM_BUBBLE_POS_INVALID 

Invalid corner.

ELM_BUBBLE_POS_TOP_LEFT 

The arrow of the bubble points to the top left corner.

ELM_BUBBLE_POS_TOP_RIGHT 

The arrow of the bubble points to the top right corner.

ELM_BUBBLE_POS_BOTTOM_LEFT 

The arrow of the bubble points to the bottom left corner.

ELM_BUBBLE_POS_BOTTOM_RIGHT 

The arrow of the bubble points to the bottom right corner.

ELM_BUBBLE_POS_INVALID 

Invalid corner.

ELM_BUBBLE_POS_TOP_LEFT 

The arrow of the bubble points to the top left corner.

ELM_BUBBLE_POS_TOP_RIGHT 

The arrow of the bubble points to the top right corner.

ELM_BUBBLE_POS_BOTTOM_LEFT 

The arrow of the bubble points to the bottom left corner.

ELM_BUBBLE_POS_BOTTOM_RIGHT 

The arrow of the bubble points to the bottom right corner.

Function Documentation

◆ elm_obj_bubble_pos_set()

EOAPI void elm_obj_bubble_pos_set ( Eo *  obj,
Elm_Bubble_Pos  pos 
)

The corner of the bubble.

This function sets the corner of the bubble. The corner will be used to determine where the arrow in the frame points to and where label, icon and info are shown. See Elm_Bubble_Pos

Parameters
[in]objThe object.
[in]posThe given corner for the bubble.

◆ elm_obj_bubble_pos_get()

EOAPI Elm_Bubble_Pos elm_obj_bubble_pos_get ( const Eo *  obj)

The corner of the bubble.

This function sets the corner of the bubble. The corner will be used to determine where the arrow in the frame points to and where label, icon and info are shown. See Elm_Bubble_Pos

Parameters
[in]objThe object.
Returns
The given corner for the bubble.

◆ elm_bubble_add()

Evas_Object* elm_bubble_add ( Evas_Object parent)

Add a new bubble to the parent.

Parameters
parentThe parent object
Returns
The new object or NULL if it cannot be created

This function adds a text bubble to the given parent evas object.

References EINA_SAFETY_ON_NULL_RETURN_VAL.