enlightenment/efl
enlightenment
/
efl
8
7
Fork 14
Code Issues 13 Pull Requests 3 Projects Releases Wiki Activity

win: Mark unstable APIs as @beta (stack API) 

We have a tag for unstable API, use it. It'll be visible in the
doc and force users to add the macro before being able to compile
code.

This amends d8dd685966.
This commit is contained in:
Jean-Philippe Andre 2017-03-29 09:39:34 +09:00
parent d8dd685966
commit c234422357
3 changed files with 15 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
src/bin/elementary/test_win_stack.c
View File

@ -1,6 +1,9 @@
#ifdef HAVE_CONFIG_H
# include "elementary_config.h"
#endif
// Stack API is still beta (and EO only)
#define EFL_UI_WIN_BETA
#include <Elementary.h>
static int level = 0;
@ -72,7 +75,7 @@ _win_new(Evas_Object *stack_top, const char *title)
static void
_bt_popto(void *data EINA_UNUSED, Evas_Object *obj EINA_UNUSED, void *event_info EINA_UNUSED)
{
elm_win_stack_pop_to(popto_win);
efl_ui_win_stack_pop_to(popto_win);
}
static void
@ -84,7 +87,7 @@ _bt_pressed(void *data, Evas_Object *obj EINA_UNUSED, void *event_info EINA_UNUS
level++;
snprintf(buf, sizeof(buf), "Level %i", level);
win = _win_new(data, buf);
elm_win_stack_master_id_set(win, elm_win_stack_id_get(data));
efl_ui_win_stack_master_id_set(win, efl_ui_win_stack_id_get(data));
evas_object_show(win);
}
@ -94,7 +97,7 @@ test_win_stack(void *data EINA_UNUSED, Evas_Object *obj EINA_UNUSED, void *event
Evas_Object *bg, *bx, *bt, *lb, *win;
win = elm_win_add(NULL, "window-stack", ELM_WIN_BASIC);
elm_win_stack_base_set(win, EINA_TRUE);
efl_ui_win_stack_base_set(win, EINA_TRUE);
elm_win_title_set(win, "Window Stack");
elm_win_autodel_set(win, EINA_TRUE);

1
src/lib/elementary/efl_ui_win.c
View File

@ -6,6 +6,7 @@
#define ELM_INTERFACE_ATSPI_WIDGET_ACTION_PROTECTED
#define EFL_INPUT_EVENT_PROTECTED
#define EFL_GFX_SIZE_HINT_PROTECTED
#define EFL_UI_WIN_BETA
#include <Elementary.h>
#include <Elementary_Cursor.h>

24
src/lib/elementary/efl_ui_win.eo
View File

@ -733,7 +733,7 @@ class Efl.Ui.Win (Elm.Widget, Efl.Canvas, Elm.Interface.Atspi.Window,
$false otherwise.]]
}
}
@property stack_id {
@property stack_id @beta {
get {
[[Get the stack ID string of the window as an opaque string.
@ -746,9 +746,7 @@ class Efl.Ui.Win (Elm.Widget, Efl.Canvas, Elm.Interface.Atspi.Window,
use by other windows to make this window part of a stack
of windows to be placed on top of eachother as if they are
a series of dialogs or questions one after the other and
that you may go back through history.
WARNING: This API is not stable - do not use yet]]
that you may go back through history.]]
}
values {
id: string; [[An opaque string that has no specific format,
@ -756,16 +754,14 @@ class Efl.Ui.Win (Elm.Widget, Efl.Canvas, Elm.Interface.Atspi.Window,
display.]]
}
}
@property stack_master_id {
@property stack_master_id @beta {
set {
[[Set the window stack ID to use as the master top-level.
This sets the ID string to be used as the master top-level
window as the base of a stack of windows. This must be set
before the first time the window is shown and should never
be changed after that point in time ever again.
WARNING: This API is not stable - do not use yet]]
be changed after that point in time ever again.]]
}
get {
[[Get the stack master Id that has been set.]]
@ -776,7 +772,7 @@ class Efl.Ui.Win (Elm.Widget, Efl.Canvas, Elm.Interface.Atspi.Window,
display.]]
}
}
@property stack_base {
@property stack_base @beta {
[[The stack base state of this window
This is a boolean flag that determines if this window will
@ -785,9 +781,7 @@ class Efl.Ui.Win (Elm.Widget, Efl.Canvas, Elm.Interface.Atspi.Window,
correctly.
This state should be set before a window is shown for the
first time and never changed again after that.
WARNING: This API is not stable - do not use yet]]
first time and never changed again after that.]]
set {}
get {}
@ -796,13 +790,11 @@ class Efl.Ui.Win (Elm.Widget, Efl.Canvas, Elm.Interface.Atspi.Window,
otherwise.]]
}
}
stack_pop_to {
stack_pop_to @beta {
[[Pop (delete) all windows in the stack above this window.
This will try and delete all the windows in the stack that
are above the window.
WARNING: This API is not stable - do not use yet]]
are above the window.]]
}
socket_listen {
[[Create a socket to provide the service for Plug widget.]]