Add the reorder feature when the more panel is shown.
[framework/uifw/elementary.git] / src / lib / elm_win.h
index b54ec90..248b14a 100644 (file)
@@ -1,5 +1,6 @@
-/* win */
-/** @defgroup Win Win
+/**
+ * @defgroup Win Win
+ * @ingroup Elementary
  *
  * @image html img/widget/win/preview-00.png
  * @image latex img/widget/win/preview-00.eps
  * window is shown before doing the virtual "in memory" rendering and then
  * save the output to the file specified by the file option (and then exit).
  * If no delay is given, the default is 0.5 seconds. If no file is given the
-<<<<<<< HEAD
- * default output file is "out.png". Repeat option is for continous
-=======
  * default output file is "out.png". Repeat option is for continuous
->>>>>>> remotes/origin/upstream
  * capturing screenshots. Repeat range is from 1 to 999 and filename is
  * fixed to "out001.png" Some examples of using the shot engine:
  *
@@ -73,8 +70,6 @@
  * @li "focus,in": window got focus
  * @li "focus,out": window lost focus
  * @li "moved": window that holds the canvas was moved
-<<<<<<< HEAD
-=======
  * @li "withdrawn": window is still managed normally but removed from view
  * @li "iconified": window is minimized (perhaps into an icon or taskbar)
  * @li "normal": window is in a normal state (not withdrawn or iconified)
@@ -84,7 +79,7 @@
  * @li "unfullscreen": window has stopped being fullscreen
  * @li "maximized": window has been maximized
  * @li "unmaximized": window has stopped being maximized
->>>>>>> remotes/origin/upstream
+ * @li "profile,changed": window's profile has been changed
  *
  * Examples:
  * @li @ref win_example_01
@@ -115,11 +110,7 @@ typedef enum
                        similar. */
    ELM_WIN_MENU, /**< Similar to #ELM_WIN_TOOLBAR. */
    ELM_WIN_UTILITY, /**< A persistent utility window, like a toolbox or
-<<<<<<< HEAD
-                       pallete. */
-=======
                        palette. */
->>>>>>> remotes/origin/upstream
    ELM_WIN_SPLASH, /**< Splash window for a starting up application. */
    ELM_WIN_DROPDOWN_MENU, /**< The window is a dropdown menu, as when an
                              entry in a menubar is clicked. Typically used
@@ -155,13 +146,9 @@ typedef enum
                              Evas_Object. */
    ELM_WIN_SOCKET_IMAGE,/**< The window is rendered onto an image buffer
                             and can be shown other process's plug image object.
-<<<<<<< HEAD
-                            No actural window is created for this type, 
-=======
-                            No actual window is created for this type, 
->>>>>>> remotes/origin/upstream
+                            No actual window is created for this type,
                             instead the window and all of its contents will be
-                            rendered to an image buffer and can be shown 
+                            rendered to an image buffer and can be shown
                             other process's plug image object*/
 } Elm_Win_Type;
 
@@ -171,10 +158,6 @@ typedef enum
  * When the application window is being managed by Illume, it may request
  * any of the following layouts for the virtual keyboard.
  */
-<<<<<<< HEAD
-// XXX: remove this as it conflicts with input panel
-=======
->>>>>>> remotes/origin/upstream
 typedef enum
 {
    ELM_WIN_KEYBOARD_UNKNOWN, /**< Unknown keyboard state */
@@ -185,11 +168,7 @@ typedef enum
    ELM_WIN_KEYBOARD_PIN, /**< PIN keyboard layout */
    ELM_WIN_KEYBOARD_PHONE_NUMBER, /**< Phone keyboard layout */
    ELM_WIN_KEYBOARD_HEX, /**< Hexadecimal numeric keyboard layout */
-<<<<<<< HEAD
-   ELM_WIN_KEYBOARD_TERMINAL, /**< Full (QUERTY) keyboard layout */
-=======
    ELM_WIN_KEYBOARD_TERMINAL, /**< Full (QWERTY) keyboard layout */
->>>>>>> remotes/origin/upstream
    ELM_WIN_KEYBOARD_PASSWORD, /**< Password keyboard layout */
    ELM_WIN_KEYBOARD_IP, /**< IP keyboard layout */
    ELM_WIN_KEYBOARD_HOST, /**< Host keyboard layout */
@@ -200,11 +179,9 @@ typedef enum
 } Elm_Win_Keyboard_Mode;
 
 /**
-<<<<<<< HEAD
-=======
  * In some environments, like phones, you may have an indicator that
  * shows battery status, reception, time etc. This is the indicator.
- * 
+ *
  * Sometimes you don't want it because you provide the same functionality
  * inside your app, so this will request that the indicator is hidden in
  * this circumstance if you use ELM_ILLUME_INDICATOR_HIDE. The default
@@ -230,7 +207,6 @@ typedef enum
 } Elm_Win_Indicator_Opacity_Mode;
 
 /**
->>>>>>> remotes/origin/upstream
  * Available commands that can be sent to the Illume manager.
  *
  * When running under an Illume session, a window may send commands to the
@@ -241,11 +217,7 @@ typedef enum
    ELM_ILLUME_COMMAND_FOCUS_BACK, /**< Reverts focus to the previous window */
    ELM_ILLUME_COMMAND_FOCUS_FORWARD, /**< Sends focus to the next window in the list */
    ELM_ILLUME_COMMAND_FOCUS_HOME, /**< Hides all windows to show the Home screen */
-<<<<<<< HEAD
-   ELM_ILLUME_COMMAND_CLOSE /**< Closes the currently active window */
-=======
    ELM_ILLUME_COMMAND_CLOSE, /**< Closes the currently active window */
->>>>>>> remotes/origin/upstream
 } Elm_Illume_Command;
 
 /**
@@ -256,15 +228,13 @@ typedef enum
  * @param name The name of the window
  * @param type The window type, one of #Elm_Win_Type.
  *
-<<<<<<< HEAD
- * The @p parent paramter can be @c NULL for every window @p type except
-=======
  * The @p parent parameter can be @c NULL for every window @p type except
->>>>>>> remotes/origin/upstream
  * #ELM_WIN_INLINED_IMAGE, which needs a parent to retrieve the canvas on
  * which the image object will be created.
  *
  * @return The created object, or NULL on failure
+ *
+ * @ingroup Win
  */
 EAPI Evas_Object          *elm_win_add(Evas_Object *parent, const char *name, Elm_Win_Type type);
 
@@ -282,6 +252,8 @@ EAPI Evas_Object          *elm_win_add(Evas_Object *parent, const char *name, El
  * @return The created object, or NULL on failure
  *
  * @see elm_win_add()
+ *
+ * @ingroup Win
  */
 EAPI Evas_Object          *elm_win_util_standard_add(const char *name, const char *title);
 
@@ -311,6 +283,8 @@ EAPI Evas_Object          *elm_win_util_standard_add(const char *name, const cha
  *
  * @param obj The window object
  * @param subobj The resize object to add
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_resize_object_add(Evas_Object *obj, Evas_Object *subobj);
 
@@ -324,6 +298,8 @@ EAPI void                  elm_win_resize_object_add(Evas_Object *obj, Evas_Obje
  *
  * @param obj The window object
  * @param subobj The resize object to add
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_resize_object_del(Evas_Object *obj, Evas_Object *subobj);
 
@@ -332,6 +308,8 @@ EAPI void                  elm_win_resize_object_del(Evas_Object *obj, Evas_Obje
  *
  * @param obj The window object
  * @param title The title to set
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_title_set(Evas_Object *obj, const char *title);
 
@@ -344,16 +322,18 @@ EAPI void                  elm_win_title_set(Evas_Object *obj, const char *title
  *
  * @param obj The window object
  * @return The title
+ *
+ * @ingroup Win
  */
 EAPI const char           *elm_win_title_get(const Evas_Object *obj);
 
 /**
-<<<<<<< HEAD
-=======
  * Set the icon name of the window
  *
  * @param obj The window object
  * @param icon_name The icon name to set
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_icon_name_set(Evas_Object *obj, const char *icon_name);
 
@@ -366,6 +346,8 @@ EAPI void                  elm_win_icon_name_set(Evas_Object *obj, const char *i
  *
  * @param obj The window object
  * @return The icon name
+ *
+ * @ingroup Win
  */
 EAPI const char           *elm_win_icon_name_get(const Evas_Object *obj);
 
@@ -374,6 +356,8 @@ EAPI const char           *elm_win_icon_name_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param role The role to set
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_role_set(Evas_Object *obj, const char *role);
 
@@ -386,21 +370,25 @@ EAPI void                  elm_win_role_set(Evas_Object *obj, const char *role);
  *
  * @param obj The window object
  * @return The role
+ *
+ * @ingroup Win
  */
 EAPI const char           *elm_win_role_get(const Evas_Object *obj);
 
 /**
  * Set the object to represent the window icon
- * 
+ *
  * This sets an object that will be used as the icon for the window. The exact
  * pixel dimensions of the object (not object size) will be used, and the
  * image pixels will be used as-is when this function is called. If the
  * image object has been updated, then call this function again to source
  * the image pixels and put them on the window's icon. This has limitations
  * as only image objects allowed at this stage. This may be lifted in future.
- * 
+ *
  * @param obj The window object
  * @param icon The object to use for an icon
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_icon_object_set(Evas_Object *obj, Evas_Object *icon);
 
@@ -412,11 +400,12 @@ EAPI void                  elm_win_icon_object_set(Evas_Object *obj, Evas_Object
  *
  * @param obj The window object
  * @return The icon object set
+ *
+ * @ingroup Win
  */
 EAPI const Evas_Object    *elm_win_icon_object_get(const Evas_Object *obj);
 
 /**
->>>>>>> remotes/origin/upstream
  * Set the window's autodel state.
  *
  * When closing the window in any way outside of the program control, like
@@ -433,6 +422,8 @@ EAPI const Evas_Object    *elm_win_icon_object_get(const Evas_Object *obj);
  * @param obj The window object
  * @param autodel If true, the window will automatically delete itself when
  * closed
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_autodel_set(Evas_Object *obj, Eina_Bool autodel);
 
@@ -443,6 +434,8 @@ EAPI void                  elm_win_autodel_set(Evas_Object *obj, Eina_Bool autod
  * @return If the window will automatically delete itself when closed
  *
  * @see elm_win_autodel_set()
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_autodel_get(const Evas_Object *obj);
 
@@ -458,6 +451,8 @@ EAPI Eina_Bool             elm_win_autodel_get(const Evas_Object *obj);
  * active one after it.
  *
  * @param obj The window object
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_activate(Evas_Object *obj);
 
@@ -471,6 +466,8 @@ EAPI void                  elm_win_activate(Evas_Object *obj);
  * request.
  *
  * @param obj The window object
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_lower(Evas_Object *obj);
 
@@ -484,6 +481,8 @@ EAPI void                  elm_win_lower(Evas_Object *obj);
  * request.
  *
  * @param obj The window object
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_raise(Evas_Object *obj);
 
@@ -491,14 +490,12 @@ EAPI void                  elm_win_raise(Evas_Object *obj);
  * Center a window on its screen
  *
  * This function centers window @p obj horizontally and/or vertically based on the values
-<<<<<<< HEAD
- * of @p h and @v.
-=======
  * of @p h and @p v.
->>>>>>> remotes/origin/upstream
  * @param obj The window object
  * @param h If true, center horizontally. If false, do not change horizontal location.
  * @param v If true, center vertically. If false, do not change vertical location.
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_center(Evas_Object *obj, Eina_Bool h, Eina_Bool v);
 
@@ -510,6 +507,8 @@ EAPI void                  elm_win_center(Evas_Object *obj, Eina_Bool h, Eina_Bo
  *
  * @param obj The window object
  * @param borderless If true, the window is borderless
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_borderless_set(Evas_Object *obj, Eina_Bool borderless);
 
@@ -518,6 +517,8 @@ EAPI void                  elm_win_borderless_set(Evas_Object *obj, Eina_Bool bo
  *
  * @param obj The window object
  * @return If true, the window is borderless
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_borderless_get(const Evas_Object *obj);
 
@@ -527,11 +528,7 @@ EAPI Eina_Bool             elm_win_borderless_get(const Evas_Object *obj);
  * Shaped windows, when supported, will render the parts of the window that
  * has no content, transparent.
  *
-<<<<<<< HEAD
- * If @p shaped is EINA_FALSE, then it is strongly adviced to have some
-=======
  * If @p shaped is EINA_FALSE, then it is strongly advised to have some
->>>>>>> remotes/origin/upstream
  * background object or cover the entire window in any other way, or the
  * parts of the canvas that have no data will show framebuffer artifacts.
  *
@@ -539,6 +536,8 @@ EAPI Eina_Bool             elm_win_borderless_get(const Evas_Object *obj);
  * @param shaped If true, the window is shaped
  *
  * @see elm_win_alpha_set()
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_shaped_set(Evas_Object *obj, Eina_Bool shaped);
 
@@ -549,6 +548,8 @@ EAPI void                  elm_win_shaped_set(Evas_Object *obj, Eina_Bool shaped
  * @return If true, the window is shaped
  *
  * @see elm_win_shaped_set()
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_shaped_get(const Evas_Object *obj);
 
@@ -566,41 +567,18 @@ EAPI Eina_Bool             elm_win_shaped_get(const Evas_Object *obj);
  * @param alpha If true, the window has an alpha channel
  *
  * @see elm_win_alpha_set()
- */
-EAPI void                  elm_win_alpha_set(Evas_Object *obj, Eina_Bool alpha);
-
-/**
-<<<<<<< HEAD
- * Get the transparency state of a window.
- *
- * @param obj The window object
- * @return If true, the window is transparent
- *
- * @see elm_win_transparent_set()
- */
-// XXX: deprecate this
-EAPI Eina_Bool             elm_win_transparent_get(const Evas_Object *obj);
-
-/**
- * Set the transparency state of a window.
- *
- * Use elm_win_alpha_set() instead.
  *
- * @param obj The window object
- * @param transparent If true, the window is transparent
- *
- * @see elm_win_alpha_set()
+ * @ingroup Win
  */
-// XXX: deprecate this
-EAPI void                  elm_win_transparent_set(Evas_Object *obj, Eina_Bool transparent);
+EAPI void                  elm_win_alpha_set(Evas_Object *obj, Eina_Bool alpha);
 
 /**
-=======
->>>>>>> remotes/origin/upstream
  * Get the alpha channel state of a window.
  *
  * @param obj The window object
  * @return If true, the window has an alpha channel
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_alpha_get(const Evas_Object *obj);
 
@@ -619,6 +597,8 @@ EAPI Eina_Bool             elm_win_alpha_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param override If true, the window is overridden
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_override_set(Evas_Object *obj, Eina_Bool override);
 
@@ -629,6 +609,8 @@ EAPI void                  elm_win_override_set(Evas_Object *obj, Eina_Bool over
  * @return If true, the window is overridden
  *
  * @see elm_win_override_set()
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_override_get(const Evas_Object *obj);
 
@@ -637,6 +619,8 @@ EAPI Eina_Bool             elm_win_override_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param fullscreen If true, the window is fullscreen
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_fullscreen_set(Evas_Object *obj, Eina_Bool fullscreen);
 
@@ -645,6 +629,8 @@ EAPI void                  elm_win_fullscreen_set(Evas_Object *obj, Eina_Bool fu
  *
  * @param obj The window object
  * @return If true, the window is fullscreen
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_fullscreen_get(const Evas_Object *obj);
 
@@ -653,6 +639,8 @@ EAPI Eina_Bool             elm_win_fullscreen_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param maximized If true, the window is maximized
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_maximized_set(Evas_Object *obj, Eina_Bool maximized);
 
@@ -661,6 +649,8 @@ EAPI void                  elm_win_maximized_set(Evas_Object *obj, Eina_Bool max
  *
  * @param obj The window object
  * @return If true, the window is maximized
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_maximized_get(const Evas_Object *obj);
 
@@ -669,6 +659,8 @@ EAPI Eina_Bool             elm_win_maximized_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param iconified If true, the window is iconified
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_iconified_set(Evas_Object *obj, Eina_Bool iconified);
 
@@ -677,16 +669,18 @@ EAPI void                  elm_win_iconified_set(Evas_Object *obj, Eina_Bool ico
  *
  * @param obj The window object
  * @return If true, the window is iconified
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_iconified_get(const Evas_Object *obj);
 
 /**
-<<<<<<< HEAD
-=======
  * Set the withdrawn state of a window.
  *
  * @param obj The window object
  * @param withdrawn If true, the window is withdrawn
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_withdrawn_set(Evas_Object *obj, Eina_Bool withdrawn);
 
@@ -695,14 +689,43 @@ EAPI void                  elm_win_withdrawn_set(Evas_Object *obj, Eina_Bool wit
  *
  * @param obj The window object
  * @return If true, the window is withdrawn
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_withdrawn_get(const Evas_Object *obj);
 
 /**
+ * Set the profile list of a window.
+ *
+ * @param obj The window object
+ * @param profiles The list of profile's name
+ * @param num_profiles The number of profile names
+ *
+ * @ingroup Win
+ */
+EAPI void                  elm_win_profiles_set(Evas_Object *obj, const char **profiles, unsigned int num_profiles);
+
+/**
+ * Get the profile of a window.
+ *
+ * The returned string is an internal one and should not be freed or
+ * modified. It will also be rendered invalid if a new role is set or if
+ * the window is destroyed.
+ *
+ * @param obj The window object
+ * @return The profile's name
+ *
+ * @ingroup Win
+ */
+EAPI const char           *elm_win_profile_get(const Evas_Object *obj);
+
+/**
  * Set the urgent state of a window.
  *
  * @param obj The window object
  * @param urgent If true, the window is urgent
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_urgent_set(Evas_Object *obj, Eina_Bool urgent);
 
@@ -711,6 +734,8 @@ EAPI void                  elm_win_urgent_set(Evas_Object *obj, Eina_Bool urgent
  *
  * @param obj The window object
  * @return If true, the window is urgent
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_urgent_get(const Evas_Object *obj);
 
@@ -719,6 +744,8 @@ EAPI Eina_Bool             elm_win_urgent_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param demand_attention If true, the window is demand_attention
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_demand_attention_set(Evas_Object *obj, Eina_Bool demand_attention);
 
@@ -727,6 +754,8 @@ EAPI void                  elm_win_demand_attention_set(Evas_Object *obj, Eina_B
  *
  * @param obj The window object
  * @return If true, the window is demand_attention
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_demand_attention_get(const Evas_Object *obj);
 
@@ -735,6 +764,8 @@ EAPI Eina_Bool             elm_win_demand_attention_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param modal If true, the window is modal
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_modal_set(Evas_Object *obj, Eina_Bool modal);
 
@@ -743,6 +774,8 @@ EAPI void                  elm_win_modal_set(Evas_Object *obj, Eina_Bool modal);
  *
  * @param obj The window object
  * @return If true, the window is modal
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_modal_get(const Evas_Object *obj);
 
@@ -752,6 +785,8 @@ EAPI Eina_Bool             elm_win_modal_get(const Evas_Object *obj);
  * @param obj The window object
  * @param aspect If 0, the window has no aspect limits, otherwise it is
  * width divided by height
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_aspect_set(Evas_Object *obj, double aspect);
 
@@ -760,11 +795,12 @@ EAPI void                  elm_win_aspect_set(Evas_Object *obj, double aspect);
  *
  * @param obj The window object
  * @return The aspect ratio set (0 by default)
+ *
+ * @ingroup Win
  */
 EAPI double                elm_win_aspect_get(const Evas_Object *obj);
 
 /**
->>>>>>> remotes/origin/upstream
  * Set the layer of the window.
  *
  * What this means exactly will depend on the underlying engine used.
@@ -777,6 +813,8 @@ EAPI double                elm_win_aspect_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param layer The layer of the window
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_layer_set(Evas_Object *obj, int layer);
 
@@ -787,6 +825,8 @@ EAPI void                  elm_win_layer_set(Evas_Object *obj, int layer);
  * @return The layer of the window
  *
  * @see elm_win_layer_set()
+ *
+ * @ingroup Win
  */
 EAPI int                   elm_win_layer_get(const Evas_Object *obj);
 
@@ -803,6 +843,8 @@ EAPI int                   elm_win_layer_get(const Evas_Object *obj);
  * @param obj The window object
  * @param rotation The rotation of the window, in degrees (0-360),
  * counter-clockwise.
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_rotation_set(Evas_Object *obj, int rotation);
 
@@ -815,6 +857,8 @@ EAPI void                  elm_win_rotation_set(Evas_Object *obj, int rotation);
  * @param obj The window object
  * @param rotation The rotation of the window in degrees (0-360),
  * counter-clockwise.
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_rotation_with_resize_set(Evas_Object *obj, int rotation);
 
@@ -826,6 +870,8 @@ EAPI void                  elm_win_rotation_with_resize_set(Evas_Object *obj, in
  *
  * @see elm_win_rotation_set()
  * @see elm_win_rotation_with_resize_set()
+ *
+ * @ingroup Win
  */
 EAPI int                   elm_win_rotation_get(const Evas_Object *obj);
 
@@ -837,6 +883,8 @@ EAPI int                   elm_win_rotation_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param sticky If true, the window's sticky state is enabled
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_sticky_set(Evas_Object *obj, Eina_Bool sticky);
 
@@ -847,6 +895,8 @@ EAPI void                  elm_win_sticky_set(Evas_Object *obj, Eina_Bool sticky
  * @return If true, the window's sticky state is enabled
  *
  * @see elm_win_sticky_set()
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_sticky_get(const Evas_Object *obj);
 
@@ -855,6 +905,8 @@ EAPI Eina_Bool             elm_win_sticky_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param conformant The conformant flag (1 = conformant, 0 = non-conformant)
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_conformant_set(Evas_Object *obj, Eina_Bool conformant);
 
@@ -863,6 +915,8 @@ EAPI void                  elm_win_conformant_set(Evas_Object *obj, Eina_Bool co
  *
  * @param obj The window object
  * @return A boolean if this window is illume conformant or not
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_conformant_get(const Evas_Object *obj);
 
@@ -873,6 +927,8 @@ EAPI Eina_Bool             elm_win_conformant_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param quickpanel The quickpanel flag (1 = quickpanel, 0 = normal window)
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_quickpanel_set(Evas_Object *obj, Eina_Bool quickpanel);
 
@@ -881,6 +937,8 @@ EAPI void                  elm_win_quickpanel_set(Evas_Object *obj, Eina_Bool qu
  *
  * @param obj The window object
  * @return A boolean if this window is a quickpanel or not
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_quickpanel_get(const Evas_Object *obj);
 
@@ -889,6 +947,8 @@ EAPI Eina_Bool             elm_win_quickpanel_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param priority The major priority for this quickpanel
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_quickpanel_priority_major_set(Evas_Object *obj, int priority);
 
@@ -897,6 +957,8 @@ EAPI void                  elm_win_quickpanel_priority_major_set(Evas_Object *ob
  *
  * @param obj The window object
  * @return The major priority of this quickpanel
+ *
+ * @ingroup Win
  */
 EAPI int                   elm_win_quickpanel_priority_major_get(const Evas_Object *obj);
 
@@ -905,6 +967,8 @@ EAPI int                   elm_win_quickpanel_priority_major_get(const Evas_Obje
  *
  * @param obj The window object
  * @param priority The minor priority for this quickpanel
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_quickpanel_priority_minor_set(Evas_Object *obj, int priority);
 
@@ -913,6 +977,8 @@ EAPI void                  elm_win_quickpanel_priority_minor_set(Evas_Object *ob
  *
  * @param obj The window object
  * @return The minor priority of this quickpanel
+ *
+ * @ingroup Win
  */
 EAPI int                   elm_win_quickpanel_priority_minor_get(const Evas_Object *obj);
 
@@ -921,6 +987,8 @@ EAPI int                   elm_win_quickpanel_priority_minor_get(const Evas_Obje
  *
  * @param obj The window object
  * @param zone The requested zone for this quickpanel
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_quickpanel_zone_set(Evas_Object *obj, int zone);
 
@@ -929,6 +997,8 @@ EAPI void                  elm_win_quickpanel_zone_set(Evas_Object *obj, int zon
  *
  * @param obj The window object
  * @return The requested zone for this quickpanel
+ *
+ * @ingroup Win
  */
 EAPI int                   elm_win_quickpanel_zone_get(const Evas_Object *obj);
 
@@ -950,6 +1020,8 @@ EAPI int                   elm_win_quickpanel_zone_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param skip The skip flag state (EINA_TRUE if it is to be skipped)
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_prop_focus_skip_set(Evas_Object *obj, Eina_Bool skip);
 
@@ -966,6 +1038,8 @@ EAPI void                  elm_win_prop_focus_skip_set(Evas_Object *obj, Eina_Bo
  * @param obj The window object that lives in the environment to control
  * @param command The command to send
  * @param params Optional parameters for the command
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_illume_command_send(Evas_Object *obj, Elm_Illume_Command command, void *params);
 
@@ -980,6 +1054,8 @@ EAPI void                  elm_win_illume_command_send(Evas_Object *obj, Elm_Ill
  *
  * @param obj The window object to get the inlined image from
  * @return The inlined image object, or NULL if none exists
+ *
+ * @ingroup Win
  */
 EAPI Evas_Object          *elm_win_inlined_image_object_get(Evas_Object *obj);
 
@@ -987,6 +1063,8 @@ EAPI Evas_Object          *elm_win_inlined_image_object_get(Evas_Object *obj);
  * Determine whether a window has focus
  * @param obj The window to query
  * @return EINA_TRUE if the window exists and has focus, else EINA_FALSE
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_focus_get(const Evas_Object *obj);
 
@@ -996,6 +1074,8 @@ EAPI Eina_Bool             elm_win_focus_get(const Evas_Object *obj);
  * When @p constrain is true, @p obj will never resize larger than the screen.
  * @param obj The window object
  * @param constrain EINA_TRUE to restrict the window's maximum size, EINA_FALSE to disable restriction
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_screen_constrain_set(Evas_Object *obj, Eina_Bool constrain);
 
@@ -1005,6 +1085,8 @@ EAPI void                  elm_win_screen_constrain_set(Evas_Object *obj, Eina_B
  * When this function returns true, @p obj will never resize larger than the screen.
  * @param obj The window object
  * @return EINA_TRUE to restrict the window's maximum size, EINA_FALSE to disable restriction
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_screen_constrain_get(Evas_Object *obj);
 
@@ -1015,6 +1097,8 @@ EAPI Eina_Bool             elm_win_screen_constrain_get(Evas_Object *obj);
  * @param y    where to return the vertical offset value. May be NULL.
  * @param w    where to return the width value. May be NULL.
  * @param h    where to return the height value. May be NULL.
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_screen_size_get(const Evas_Object *obj, int *x, int *y, int *w, int *h);
 
@@ -1026,6 +1110,8 @@ EAPI void                  elm_win_screen_size_get(const Evas_Object *obj, int *
  *
  * @param obj The window where to enable the highlight
  * @param enabled The enabled value for the highlight
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_focus_highlight_enabled_set(Evas_Object *obj, Eina_Bool enabled);
 
@@ -1035,6 +1121,8 @@ EAPI void                  elm_win_focus_highlight_enabled_set(Evas_Object *obj,
  * @param obj The window in which to check if the focus highlight is enabled
  *
  * @return EINA_TRUE if enabled, EINA_FALSE otherwise
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_focus_highlight_enabled_get(const Evas_Object *obj);
 
@@ -1046,48 +1134,32 @@ EAPI Eina_Bool             elm_win_focus_highlight_enabled_get(const Evas_Object
  *
  * @param obj The window where to set the style
  * @param style The style to set
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_focus_highlight_style_set(Evas_Object *obj, const char *style);
 
 /**
  * Get the style set for the focus highlight object
  *
-<<<<<<< HEAD
- * Gets the style set for this windows highilght object, or NULL if none
-=======
  * Gets the style set for this windows highlight object, or NULL if none
->>>>>>> remotes/origin/upstream
  * is set.
  *
  * @param obj The window to retrieve the highlights style from
  *
  * @return The style set or NULL if none was. Default is used in that case.
- */
-EAPI const char           *elm_win_focus_highlight_style_get(const Evas_Object *obj);
-<<<<<<< HEAD
-EAPI void                  elm_win_indicator_state_set(Evas_Object *obj, int show_state);
-EAPI int                   elm_win_indicator_state_get(Evas_Object *obj);
-/*...
- * ecore_x_icccm_hints_set -> accepts_focus (add to ecore_evas)
- * ecore_x_icccm_hints_set -> window_group (add to ecore_evas)
- * ecore_x_icccm_size_pos_hints_set -> request_pos (add to ecore_evas)
- * ecore_x_icccm_client_leader_set -> l (add to ecore_evas)
- * ecore_x_icccm_window_role_set -> role (add to ecore_evas)
- * ecore_x_icccm_transient_for_set -> forwin (add to ecore_evas)
- * ecore_x_netwm_window_type_set -> type (add to ecore_evas)
- *
- * (add to ecore_x) set netwm argb icon! (add to ecore_evas)
- * (blank mouse, private mouse obj, defaultmouse)
  *
+ * @ingroup Win
  */
-=======
->>>>>>> remotes/origin/upstream
+EAPI const char           *elm_win_focus_highlight_style_get(const Evas_Object *obj);
 
 /**
  * Sets the keyboard mode of the window.
  *
  * @param obj The window object
  * @param mode The mode to set, one of #Elm_Win_Keyboard_Mode
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_keyboard_mode_set(Evas_Object *obj, Elm_Win_Keyboard_Mode mode);
 
@@ -1096,6 +1168,8 @@ EAPI void                  elm_win_keyboard_mode_set(Evas_Object *obj, Elm_Win_K
  *
  * @param obj The window object
  * @return The mode, one of #Elm_Win_Keyboard_Mode
+ *
+ * @ingroup Win
  */
 EAPI Elm_Win_Keyboard_Mode elm_win_keyboard_mode_get(const Evas_Object *obj);
 
@@ -1104,6 +1178,8 @@ EAPI Elm_Win_Keyboard_Mode elm_win_keyboard_mode_get(const Evas_Object *obj);
  *
  * @param obj The window object
  * @param is_keyboard If true, the window is a virtual keyboard
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_keyboard_win_set(Evas_Object *obj, Eina_Bool is_keyboard);
 
@@ -1112,32 +1188,44 @@ EAPI void                  elm_win_keyboard_win_set(Evas_Object *obj, Eina_Bool
  *
  * @param obj The window object
  * @return If the window is a virtual keyboard
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_keyboard_win_get(const Evas_Object *obj);
 
 /**
-<<<<<<< HEAD
-=======
  * Sets the indicator mode of the window.
  *
  * @param obj The window object
  * @param mode The mode to set, one of #Elm_Win_Indicator_Mode
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_indicator_mode_set(Evas_Object *obj, Elm_Win_Indicator_Mode mode);
 
+// WRAPPER: Temperary added.
+EAPI void                  elm_win_indicator_state_set(Evas_Object *obj, Elm_Win_Indicator_Mode mode);
+
 /**
  * Gets the indicator mode of the window.
  *
  * @param obj The window object
  * @return The mode, one of #Elm_Win_Indicator_Mode
+ *
+ * @ingroup Win
  */
 EAPI Elm_Win_Indicator_Mode elm_win_indicator_mode_get(const Evas_Object *obj);
 
+// WRAPPER: Temperary added.
+EAPI Elm_Win_Indicator_Mode elm_win_indicator_state_get(const Evas_Object *obj);
+
 /**
  * Sets the indicator opacity mode of the window.
  *
  * @param obj The window object
  * @param mode The mode to set, one of #Elm_Win_Indicator_Opacity_Mode
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_indicator_opacity_set(Evas_Object *obj, Elm_Win_Indicator_Opacity_Mode mode);
 
@@ -1146,16 +1234,19 @@ EAPI void                  elm_win_indicator_opacity_set(Evas_Object *obj, Elm_W
  *
  * @param obj The window object
  * @return The mode, one of #Elm_Win_Indicator_Opacity_Mode
+ *
+ * @ingroup Win
  */
 EAPI Elm_Win_Indicator_Opacity_Mode elm_win_indicator_opacity_get(const Evas_Object *obj);
 
 /**
->>>>>>> remotes/origin/upstream
  * Get the screen position of a window.
  *
  * @param obj The window object
  * @param x The int to store the x coordinate to
  * @param y The int to store the y coordinate to
+ *
+ * @ingroup Win
  */
 EAPI void                  elm_win_screen_position_get(const Evas_Object *obj, int *x, int *y);
 
@@ -1164,23 +1255,33 @@ EAPI void                  elm_win_screen_position_get(const Evas_Object *obj, i
  *
  * @param obj The window object
  * @param svcname The name of the service to be advertised. ensure that it is unique (when combined with @p svcnum) otherwise creation may fail.
-<<<<<<< HEAD
- * @param svcnum A number (any value, 0 beig the common default) to differentiate multiple instances of services with the same name.
- * @param svcsys A boolean that if true, specifies to create a system-wide service all users can connect to, otherwise the service is private to the user ide that created the service.
-=======
  * @param svcnum A number (any value, 0 being the common default) to differentiate multiple instances of services with the same name.
  * @param svcsys A boolean that if true, specifies to create a system-wide service all users can connect to, otherwise the service is private to the user id that created the service.
->>>>>>> remotes/origin/upstream
  * @return If socket creation is successful
+ *
+ * @ingroup Win
  */
 EAPI Eina_Bool             elm_win_socket_listen(Evas_Object *obj, const char *svcname, int svcnum, Eina_Bool svcsys);
 
+/* X specific calls - won't work on non-x engines (return 0) */
+/**
+ * Get the Ecore_X_Window of an Evas_Object
+ *
+ * @param obj The object
+ *
+ * @return The Ecore_X_Window of @p obj
+ *
+ * @ingroup Win
+ */
+EAPI Ecore_X_Window elm_win_xwindow_get(const Evas_Object *obj);
+
 /**
  * @}
  */
 
 /**
  * @defgroup Inwin Inwin
+ * @ingroup Win
  *
  * @image html img/widget/inwin/preview-00.png
  * @image latex img/widget/inwin/preview-00.eps
@@ -1229,11 +1330,9 @@ EAPI Eina_Bool             elm_win_socket_listen(Evas_Object *obj, const char *s
  *
  * @param parent The parent object
  * @return The new object or NULL if it cannot be created
+ *
+ * @ingroup Inwin
  */
-<<<<<<< HEAD
-// XXX: deprecate this
-=======
->>>>>>> remotes/origin/upstream
 EAPI Evas_Object *elm_win_inwin_add(Evas_Object *parent);
 
 /**
@@ -1248,11 +1347,9 @@ EAPI Evas_Object *elm_win_inwin_add(Evas_Object *parent);
  * source "elm".
  *
  * @param obj The inwin to activate
+ *
+ * @ingroup Inwin
  */
-<<<<<<< HEAD
-// XXX: deprecate this
-=======
->>>>>>> remotes/origin/upstream
 EAPI void         elm_win_inwin_activate(Evas_Object *obj);
 
 /**
@@ -1264,21 +1361,15 @@ EAPI void         elm_win_inwin_activate(Evas_Object *obj);
  *
  * @param obj The inwin object
  * @param content The object to set as content
+ *
+ * @ingroup Inwin
  */
-<<<<<<< HEAD
-// XXX: deprecate this
-=======
->>>>>>> remotes/origin/upstream
 EAPI void         elm_win_inwin_content_set(Evas_Object *obj, Evas_Object *content);
 
 /**
  * Get the content of an inwin object.
  *
-<<<<<<< HEAD
- * Return the content object which is set for this widget.
-=======
  * Return the content object for this widget.
->>>>>>> remotes/origin/upstream
  *
  * The returned object is valid as long as the inwin is still alive and no
  * other content is set on it. Deleting the object will notify the inwin
@@ -1289,11 +1380,9 @@ EAPI void         elm_win_inwin_content_set(Evas_Object *obj, Evas_Object *conte
  *
  * @param obj The inwin object
  * @return The content that is being used
+ *
+ * @ingroup Inwin
  */
-<<<<<<< HEAD
-// XXX: deprecate this
-=======
->>>>>>> remotes/origin/upstream
 EAPI Evas_Object *elm_win_inwin_content_get(const Evas_Object *obj);
 
 /**
@@ -1303,32 +1392,33 @@ EAPI Evas_Object *elm_win_inwin_content_get(const Evas_Object *obj);
  *
  * @param obj The inwin object
  * @return The content that was being used
+ *
+ * @ingroup Inwin
  */
-<<<<<<< HEAD
-// XXX: deprecate this
-=======
->>>>>>> remotes/origin/upstream
 EAPI Evas_Object *elm_win_inwin_content_unset(Evas_Object *obj);
 
 /**
- * @}
+ * Set the floating mode of a window.
+ *
+ * @param obj The window object
+ * @param floating If true, the window is floating mode
+ *
+ * @ingroup Win
  */
-/* X specific calls - won't work on non-x engines (return 0) */
+EAPI void                  elm_win_floating_mode_set(Evas_Object *obj, Eina_Bool floating);
 
 /**
- * Get the Ecore_X_Window of an Evas_Object
- *
- * @param obj The object
+ * Get the floating mode of a window.
  *
- * @return The Ecore_X_Window of @p obj
+ * @param obj The window object
+ * @return If true, the window is floating mode
  *
  * @ingroup Win
  */
-EAPI Ecore_X_Window elm_win_xwindow_get(const Evas_Object *obj);
+EAPI Eina_Bool             elm_win_floating_mode_get(const Evas_Object *obj);
+
 
-/* smart callbacks called:
- * "delete,request" - the user requested to delete the window
- * "focus,in" - window got focus
- * "focus,out" - window lost focus
- * "moved" - window that holds the canvas was moved
+/**
+ * @}
  */
+