Conformant
Elementary

## 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_Object * | elm_conformant_add (Evas_Object *parent)
| Add a new conformant widget to the given parent Elementary (container) object.
EINA_DEPRECATED void | elm_conformant_content_set (Evas_Object *obj, Evas_Object *content)
| Set the content of the conformant widget.
EINA_DEPRECATED Evas_Object * | elm_conformant_content_get (const Evas_Object *obj)
| Get the content of the conformant widget.
EINA_DEPRECATED Evas_Object * | elm_conformant_content_unset (Evas_Object *obj)
| Unset the content of the conformant widget.

## 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 :

- "virtualkeypad,state,on": if virtualkeypad state is switched to "on". (since 1.8)
- "virtualkeypad,state,off": if virtualkeypad state is switched to "off". (since 1.8)
- "clipboard,state,on": if clipboard state is switched to "on". (since 1.8)
- "clipboard,state,off": if clipboard state is switched to "off". (since 1.8) In all cases, the `event` parameter of the callback will be `NULL`.

Available styles for it:

- `"default"`

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

- "default" - A content of the conformant

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

  parent | The 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

  obj | The conformant object.
  content | The 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

References EINA_DEPRECATED.

## elm_conformant_content_get()

EINA_DEPRECATED Evas_Object * elm_conformant_content_get | ( | const Evas_Object * | obj | ) |

Get the content of the conformant widget.

Parameters

  obj | The 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

References EINA_DEPRECATED.

## elm_conformant_content_unset()

EINA_DEPRECATED Evas_Object * elm_conformant_content_unset | ( | Evas_Object * | obj | ) |

Unset the content of the conformant widget.

Parameters

  obj | The 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

References EINA_DEPRECATED.