2012-01-16 09:18:20 -08:00
|
|
|
/**
|
|
|
|
* @defgroup Plug Plug
|
2012-04-16 18:35:46 -07:00
|
|
|
* @ingroup Elementary
|
2012-01-16 09:18:20 -08:00
|
|
|
*
|
2012-06-05 15:41:21 -07:00
|
|
|
* @image html plug_inheritance_tree.png
|
|
|
|
* @image latex plug_inheritance_tree.eps
|
|
|
|
*
|
2012-03-28 02:02:22 -07:00
|
|
|
* An object that allows one to show an image which other process created.
|
2012-01-16 09:18:20 -08:00
|
|
|
* It can be used anywhere like any other elementary widget.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
2012-11-25 22:32:53 -08:00
|
|
|
#define ELM_OBJ_PLUG_CLASS elm_obj_plug_class_get()
|
|
|
|
|
|
|
|
const Eo_Class *elm_obj_plug_class_get(void) EINA_CONST;
|
|
|
|
|
|
|
|
extern EAPI Eo_Op ELM_OBJ_PLUG_BASE_ID;
|
|
|
|
|
|
|
|
enum
|
|
|
|
{
|
|
|
|
ELM_OBJ_PLUG_SUB_ID_IMAGE_OBJECT_GET,
|
|
|
|
ELM_OBJ_PLUG_SUB_ID_CONNECT,
|
|
|
|
ELM_OBJ_PLUG_SUB_ID_LAST
|
|
|
|
};
|
|
|
|
|
|
|
|
#define ELM_OBJ_PLUG_ID(sub_id) (ELM_OBJ_PLUG_BASE_ID + sub_id)
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @def elm_obj_plug_image_object_get
|
|
|
|
* @since 1.8
|
|
|
|
*
|
|
|
|
* Get the basic Evas_Image object from this object (widget).
|
|
|
|
*
|
|
|
|
* @param[out] ret
|
|
|
|
*
|
|
|
|
* @see elm_plug_image_object_get
|
|
|
|
*/
|
|
|
|
#define elm_obj_plug_image_object_get(ret) ELM_OBJ_PLUG_ID(ELM_OBJ_PLUG_SUB_ID_IMAGE_OBJECT_GET), EO_TYPECHECK(Evas_Object **, ret)
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @def elm_obj_plug_connect
|
|
|
|
* @since 1.8
|
|
|
|
*
|
|
|
|
* Connect a plug widget to service provided by socket image.
|
|
|
|
*
|
|
|
|
* @param[in] svcname
|
|
|
|
* @param[in] svcnum
|
|
|
|
* @param[in] svcsys
|
|
|
|
* @param[out] ret
|
|
|
|
*
|
|
|
|
* @see elm_plug_connect
|
|
|
|
*/
|
|
|
|
#define elm_obj_plug_connect(svcname, svcnum, svcsys, ret) ELM_OBJ_PLUG_ID(ELM_OBJ_PLUG_SUB_ID_CONNECT), EO_TYPECHECK(const char *, svcname), EO_TYPECHECK(int, svcnum), EO_TYPECHECK(Eina_Bool, svcsys), EO_TYPECHECK(Eina_Bool *, ret)
|
2012-01-16 09:18:20 -08:00
|
|
|
/**
|
|
|
|
* @addtogroup Plug
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Add a new plug image to the parent.
|
|
|
|
*
|
|
|
|
* @param parent The parent object
|
|
|
|
* @return The new plug image object or NULL if it cannot be created
|
|
|
|
*
|
|
|
|
* @ingroup Plug
|
|
|
|
*/
|
|
|
|
EAPI Evas_Object *elm_plug_add(Evas_Object *parent);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Connect a plug widget to service provided by socket image.
|
|
|
|
*
|
2012-02-16 00:28:33 -08:00
|
|
|
* @param obj The Evas_Object where the new image object will live.
|
2012-01-16 09:18:20 -08:00
|
|
|
* @param svcname The service name to connect to set up by the socket.
|
|
|
|
* @param svcnum The service number to connect to (set up by socket).
|
2012-02-14 00:50:46 -08:00
|
|
|
* @param svcsys Boolean to set if the service is a system one or not (set up by socket).
|
2012-01-16 09:18:20 -08:00
|
|
|
* @return (@c EINA_TRUE = success, @c EINA_FALSE = error)
|
|
|
|
*
|
|
|
|
* @ingroup Plug
|
|
|
|
*/
|
|
|
|
EAPI Eina_Bool elm_plug_connect(Evas_Object *obj, const char *svcname, int svcnum, Eina_Bool svcsys);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the basic Evas_Image object from this object (widget).
|
|
|
|
*
|
|
|
|
* @param obj The image object to get the inlined image from
|
|
|
|
* @return The inlined image object, or NULL if none exists
|
|
|
|
*
|
|
|
|
* This function allows one to get the underlying @c Evas_Object of type
|
|
|
|
* Image from this elementary widget. It can be useful to do things like get
|
|
|
|
* the pixel data, save the image to a file, etc.
|
|
|
|
*
|
|
|
|
* @note Be careful to not manipulate it, as it is under control of
|
|
|
|
* elementary.
|
|
|
|
*
|
|
|
|
* @ingroup Plug
|
|
|
|
*/
|
|
|
|
EAPI Evas_Object *elm_plug_image_object_get(const Evas_Object *obj);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|