diff --git a/doc/elementary/combobox.rst b/doc/elementary/combobox.rst index 713416a..71636a6 100644 --- a/doc/elementary/combobox.rst +++ b/doc/elementary/combobox.rst @@ -3,8 +3,18 @@ Combobox ######## -.. image:: /images/combobox-preview.png +.. warning:: + **THE COMBOBOX IS BROKEN AND DEPRECATED, DO NOT USE IN ANY CASE !!** + The behaviour and the API of the Combobox will change in future release. + + If you are already using this we really encourage you to switch + to other widgets. + + We are really sorry about this breakage, but there is nothing we can do + to avoid this :( + +.. image:: /images/combobox-preview.png Widget description ================== diff --git a/efl/elementary/combobox.pxi b/efl/elementary/combobox.pxi index 5253468..f32b609 100644 --- a/efl/elementary/combobox.pxi +++ b/efl/elementary/combobox.pxi @@ -97,8 +97,22 @@ class Combobox(_Combobox, Button, Entry, Genlist, Hover): This is the class that actually implements the widget. + .. warning:: + **THE COMBOBOX WIDGET IS BROKEN AND DEPRECATED, DO NOT USE IN ANY CASE !!** + + The behaviour and the API of the Combobox will change in future release. + + If you are already using this we really encourage you to switch + to other widgets. + + We are really sorry about this breakage, but there is nothing we can do + to avoid this :( + .. versionadded:: 1.17 + .. versionchanged:: 1.18 + The combobox widget has been deprecated. Don't use it in ANY case. + """ def __init__(self, evasObject parent, *args, **kwargs): """Combobox(...) @@ -109,6 +123,17 @@ class Combobox(_Combobox, Button, Entry, Genlist, Hover): as properties of the instance """ + print(""" + **THE COMBOBOX IS BROKEN AND DEPRECATED, DO NOT USE IN ANY CASE !!** + + The behaviour and the API of the Combobox will change in future release. + + If you are already using this we really encourage you to switch + to other widgets. + + We are really sorry about this breakage, but there is nothing we can do + to avoid this :( + """) _Combobox.__init__(self, parent, *args, **kwargs) diff --git a/examples/elementary/test_combobox.py b/examples/elementary/test_combobox.py index 97b5d53..c60ed32 100644 --- a/examples/elementary/test_combobox.py +++ b/examples/elementary/test_combobox.py @@ -5,7 +5,7 @@ from efl.evas import EVAS_HINT_EXPAND, EXPAND_BOTH, EXPAND_HORIZ, FILL_HORIZ, \ EVAS_ASPECT_CONTROL_VERTICAL from efl import elementary as elm from efl.elementary import StandardWindow, Box, Button, Icon, Separator, \ - Combobox, GenlistItemClass + Combobox, GenlistItemClass, Label class ComboboxItemClass(GenlistItemClass): @@ -98,6 +98,16 @@ def combobox_clicked(obj): bx.pack_start(bt) bt.show() + lb = Label(win, text=""" +THE COMBOBOX WIDGET IS BROKEN AND DEPRECATED.
+DO NOT USE IN ANY CASE.


+The behaviour and the API of the Combobox will change in future release.

+If you are already using this we really encourage you to switch to other widgets.

+We are really sorry about this breakage, but there is nothing we can do to avoid this :(

+""") + bx.pack_start(lb) + lb.show() + # win.show()