Macros | Functions
Conformant

Macros

#define ELM_CONFORMANT_CLASS   elm_conformant_class_get()
 Elementary conformant class.
 
#define ELM_CONFORMANT_EVENT_VIRTUALKEYPAD_STATE_ON   (&(_ELM_CONFORMANT_EVENT_VIRTUALKEYPAD_STATE_ON))
 Called when virtualkeypad was enabled.
 
#define ELM_CONFORMANT_EVENT_VIRTUALKEYPAD_STATE_OFF   (&(_ELM_CONFORMANT_EVENT_VIRTUALKEYPAD_STATE_OFF))
 Called when virtualkeypad was disabled.
 
#define ELM_CONFORMANT_EVENT_CLIPBOARD_STATE_ON   (&(_ELM_CONFORMANT_EVENT_CLIPBOARD_STATE_ON))
 Called when clipboard was enabled.
 
#define ELM_CONFORMANT_EVENT_CLIPBOARD_STATE_OFF   (&(_ELM_CONFORMANT_EVENT_CLIPBOARD_STATE_OFF))
 Called when clipboard was disabled.
 

Functions

Evas_Objectelm_conformant_add (Evas_Object *parent)
 Add a new conformant widget to the given parent Elementary (container) object. More...
 
EINA_DEPRECATED void elm_conformant_content_set (Evas_Object *obj, Evas_Object *content)
 Set the content of the conformant widget. More...
 
EINA_DEPRECATED Evas_Objectelm_conformant_content_get (const Evas_Object *obj)
 Get the content of the conformant widget. More...
 
EINA_DEPRECATED Evas_Objectelm_conformant_content_unset (Evas_Object *obj)
 Unset the content of the conformant widget. More...
 

Detailed Description

The aim is to provide a widget that can be used in elementary apps to account for space taken up by the indicator, virtual keypad & softkey windows when running the illume2 module of E17.

So conformant content will be sized and positioned considering the space required for such stuff, and when they popup, as a keyboard shows when an entry is selected, conformant content won't change.

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

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

Available styles for it:

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

See how to use this widget in this example: Conformant Example.

Function Documentation

◆ elm_conformant_add()

Evas_Object * elm_conformant_add ( Evas_Object parent)

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

Parameters
parentThe parent object.
Returns
A new conformant widget handle or NULL, on errors.

This function inserts a new conformant widget on the canvas.

References EINA_SAFETY_ON_NULL_RETURN_VAL.

◆ elm_conformant_content_set()

EINA_DEPRECATED void elm_conformant_content_set ( Evas_Object obj,
Evas_Object content 
)

Set the content of the conformant widget.

Parameters
objThe conformant object.
contentThe content to be displayed by the conformant.

Content will be sized and positioned considering the space required to display a virtual keyboard. So it won't fill all the conformant size. This way is possible to be sure that content won't resize or be re-positioned after the keyboard is displayed.

Once the content object is set, a previously set one will be deleted. If you want to keep that old content object, use the elm_object_content_unset() function.

See also
elm_object_content_unset()
elm_object_content_get()
Deprecated:
use elm_object_content_set() instead

◆ elm_conformant_content_get()

EINA_DEPRECATED Evas_Object * elm_conformant_content_get ( const Evas_Object obj)

Get the content of the conformant widget.

Parameters
objThe conformant object.
Returns
The content that is being used.

Return the content object which is set for this widget. It won't be unparent from conformant. For that, use elm_object_content_unset().

See also
elm_object_content_set().
elm_object_content_unset()
Deprecated:
use elm_object_content_get() instead

◆ elm_conformant_content_unset()

EINA_DEPRECATED Evas_Object * elm_conformant_content_unset ( Evas_Object obj)

Unset the content of the conformant widget.

Parameters
objThe conformant object.
Returns
The content that was being used.

Unparent and return the content object which was set for this widget.

See also
elm_object_content_set().
Deprecated:
use elm_object_content_unset() instead