2012-04-16 18:35:46 -07:00
|
|
|
/**
|
docs: Correct the wrong API group name in Elementary and Change an invalid URL in Evas
Summary:
I had found broken URL address for SGI free software license B v2.0 and changed valid URL address
In addition, I found wrong group name in glview, grid, index, label, list, map, mapbuf, naviframe, notify, panel, photocam, plug, popup, radio, scroller, spinner, table, win, atspi, frame, access, textpath, elm_object, color_class and fixed them.
Test Plan: API reference documentation modification only
Reviewers: segfaultxavi, stefan_schmidt, raster
Reviewed By: raster
Subscribers: cedric, #reviewers, #committers
Tags: #efl
Differential Revision: https://phab.enlightenment.org/D12049
2020-07-09 02:24:09 -07:00
|
|
|
* @defgroup Elm_Win_Group Win
|
2012-04-16 18:35:46 -07:00
|
|
|
* @ingroup Elementary
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
2012-06-05 15:41:21 -07:00
|
|
|
* @image html win_inheritance_tree.png
|
|
|
|
* @image latex win_inheritance_tree.eps
|
|
|
|
*
|
2011-12-29 23:20:48 -08:00
|
|
|
* @image html img/widget/win/preview-00.png
|
|
|
|
* @image latex img/widget/win/preview-00.eps
|
|
|
|
*
|
2012-01-04 16:56:08 -08:00
|
|
|
* The window class of Elementary. Contains functions to manipulate
|
2011-12-29 23:20:48 -08:00
|
|
|
* windows. The Evas engine used to render the window contents is specified
|
|
|
|
* in the system or user elementary config files (whichever is found last),
|
|
|
|
* and can be overridden with the ELM_ENGINE environment variable for
|
|
|
|
* testing. Engines that may be supported (depending on Evas and Ecore-Evas
|
|
|
|
* compilation setup and modules actually installed at runtime) are (listed
|
|
|
|
* in order of best supported and most likely to be complete and work to
|
2014-08-21 22:48:13 -07:00
|
|
|
* lowest quality). Note that ELM_ENGINE is really only needed for special
|
|
|
|
* cases and debugging. you should normally use ELM_DISPLAY and ELM_ACCEL
|
|
|
|
* environment variables, or core elementary config. ELM_DISPLAY can be set to
|
|
|
|
* "x11" or "wl" to indicate the target display system (as on Linux systems
|
|
|
|
* you may have both display systems available, so this selects which to use).
|
|
|
|
* ELM_ACCEL may also be set to indicate if you want accelerations and which
|
|
|
|
* kind to use. see elm_config_accel_preference_set(0 for details on this
|
|
|
|
* environment variable values.
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
|
|
|
* @li "x11", "x", "software-x11", "software_x11" (Software rendering in X11)
|
|
|
|
* @li "gl", "opengl", "opengl-x11", "opengl_x11" (OpenGL or OpenGL-ES2
|
|
|
|
* rendering in X11)
|
|
|
|
* @li "shot:..." (Virtual screenshot renderer - renders to output file and
|
|
|
|
* exits)
|
|
|
|
* @li "fb", "software-fb", "software_fb" (Linux framebuffer direct software
|
|
|
|
* rendering)
|
|
|
|
* @li "sdl", "software-sdl", "software_sdl" (SDL software rendering to SDL
|
|
|
|
* buffer)
|
|
|
|
* @li "gl-sdl", "gl_sdl", "opengl-sdl", "opengl_sdl" (OpenGL or OpenGL-ES2
|
|
|
|
* rendering using SDL as the buffer)
|
|
|
|
* @li "gdi", "software-gdi", "software_gdi" (Windows WIN32 rendering via
|
|
|
|
* GDI with software)
|
2015-08-26 07:19:46 -07:00
|
|
|
* @li "ddraw", "software-ddraw", "software_ddraw" (Windows WIN32 rendering via
|
|
|
|
* DirectDraw with software)
|
2011-12-29 23:20:48 -08:00
|
|
|
* @li "gl-cocoa", "gl_cocoa", "opengl-cocoa", "opengl_cocoa" (OpenGL rendering in Cocoa)
|
2014-08-21 22:48:13 -07:00
|
|
|
* @li "wayland_shm" (Wayland client SHM rendering)
|
|
|
|
* @li "wayland_egl" (Wayland client OpenGL/EGL rendering)
|
|
|
|
* @li "drm" (Linux drm/kms etc. direct display)
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
|
|
|
* All engines use a simple string to select the engine to render, EXCEPT
|
|
|
|
* the "shot" engine. This actually encodes the output of the virtual
|
|
|
|
* screenshot and how long to delay in the engine string. The engine string
|
|
|
|
* is encoded in the following way:
|
|
|
|
*
|
|
|
|
* "shot:[delay=XX][:][repeat=DDD][:][file=XX]"
|
|
|
|
*
|
|
|
|
* Where options are separated by a ":" char if more than one option is
|
|
|
|
* given, with delay, if provided being the first option and file the last
|
|
|
|
* (order is important). The delay specifies how long to wait after the
|
|
|
|
* 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
|
2012-02-14 00:50:53 -08:00
|
|
|
* default output file is "out.png". Repeat option is for continuous
|
2011-12-29 23:20:48 -08:00
|
|
|
* capturing screenshots. Repeat range is from 1 to 999 and filename is
|
|
|
|
* fixed to "out001.png" Some examples of using the shot engine:
|
|
|
|
*
|
|
|
|
* ELM_ENGINE="shot:delay=1.0:repeat=5:file=elm_test.png" elementary_test
|
|
|
|
* ELM_ENGINE="shot:delay=1.0:file=elm_test.png" elementary_test
|
|
|
|
* ELM_ENGINE="shot:file=elm_test2.png" elementary_test
|
|
|
|
* ELM_ENGINE="shot:delay=2.0" elementary_test
|
|
|
|
* ELM_ENGINE="shot:" elementary_test
|
|
|
|
*
|
|
|
|
* Signals that you can add callbacks for are:
|
|
|
|
*
|
|
|
|
* @li "delete,request": the user requested to close the window. See
|
2015-07-01 07:40:57 -07:00
|
|
|
* elm_win_autodel_set() and elm_win_autohide_set().
|
elm: added more "focused" and "unfocused" documentations.
genlist, hover, index, list, map, photocam, progressbar, radio, scroller, slider, slideshow, spinner, toolbar, win.
2013-06-09 22:12:51 -07:00
|
|
|
* @li "focus,in": window got focus (deprecated. use "focused" instead.)
|
|
|
|
* @li "focus,out": window lost focus (deprecated. use "unfocused" instead.)
|
2011-12-29 23:20:48 -08:00
|
|
|
* @li "moved": window that holds the canvas was moved
|
2012-02-28 03:20:35 -08:00
|
|
|
* @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)
|
|
|
|
* @li "stick": window has become sticky (shows on all desktops)
|
|
|
|
* @li "unstick": window has stopped being sticky
|
|
|
|
* @li "fullscreen": window has become fullscreen
|
|
|
|
* @li "unfullscreen": window has stopped being fullscreen
|
|
|
|
* @li "maximized": window has been maximized
|
|
|
|
* @li "unmaximized": window has stopped being maximized
|
2012-08-05 21:09:02 -07:00
|
|
|
* @li "ioerr": there has been a low-level I/O error with the display system
|
2012-11-25 09:00:40 -08:00
|
|
|
* @li "indicator,prop,changed": an indicator's property has been changed
|
|
|
|
* @li "rotation,changed": window rotation has been changed
|
2012-12-04 22:50:27 -08:00
|
|
|
* @li "profile,changed": profile of the window has been changed
|
elm: added more "focused" and "unfocused" documentations.
genlist, hover, index, list, map, photocam, progressbar, radio, scroller, slider, slideshow, spinner, toolbar, win.
2013-06-09 22:12:51 -07:00
|
|
|
* @li "focused" : When the win has received focus. (since 1.8)
|
|
|
|
* @li "unfocused" : When the win has lost focus. (since 1.8)
|
2014-12-15 08:45:59 -08:00
|
|
|
* @li "theme,changed" - The theme was changed. (since 1.13)
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
2013-12-14 11:26:22 -08:00
|
|
|
* Note that calling evas_object_show() after window contents creation is
|
|
|
|
* recommended. It will trigger evas_smart_objects_calculate() and some backend
|
|
|
|
* calls directly. For example, XMapWindow is called directly during
|
|
|
|
* evas_object_show() in X11 engine.
|
|
|
|
*
|
2011-12-29 23:20:48 -08:00
|
|
|
* Examples:
|
|
|
|
* @li @ref win_example_01
|
|
|
|
*
|
|
|
|
* @{
|
|
|
|
*/
|
2012-11-25 22:32:53 -08:00
|
|
|
|
2013-04-29 00:03:21 -07:00
|
|
|
#include <elm_win_common.h>
|
|
|
|
#ifndef EFL_NOLEGACY_API_SUPPORT
|
|
|
|
#include <elm_win_legacy.h>
|
|
|
|
#endif
|
2019-03-07 07:56:32 -08:00
|
|
|
/* FIXME: what the actual fuck. */
|
|
|
|
# include <elm_win_eo.h>
|
2011-12-29 23:20:48 -08:00
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|