diff options
| author | Serhiy Storchaka <storchaka@gmail.com> | 2017-09-24 11:34:09 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2017-09-24 11:34:09 (GMT) |
| commit | 2fad10235460ac394cc8b869c41f47aba3d63594 (patch) | |
| tree | 28a55ca103201a0b6b753c0d1724708ca1f34d32 /Doc | |
| parent | c247caf33f6e6000d828db4762d1cb12edf3cd57 (diff) | |
| download | cpython-2fad10235460ac394cc8b869c41f47aba3d63594.zip cpython-2fad10235460ac394cc8b869c41f47aba3d63594.tar.gz cpython-2fad10235460ac394cc8b869c41f47aba3d63594.tar.bz2 | |
bpo-27319, bpo-31508: Document deprecation in Treeview.selection(). (#3667)
Defer removing old behavior to 3.8.
Document new feature of selection_set() and friends.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/tkinter.ttk.rst | 24 |
1 files changed, 20 insertions, 4 deletions
diff --git a/Doc/library/tkinter.ttk.rst b/Doc/library/tkinter.ttk.rst index 3dad182..927f7f3 100644 --- a/Doc/library/tkinter.ttk.rst +++ b/Doc/library/tkinter.ttk.rst @@ -1099,26 +1099,42 @@ ttk.Treeview If *selop* is not specified, returns selected items. Otherwise, it will act according to the following selection methods. + .. deprecated-removed:: 3.6 3.8 + Using ``selection()`` for changing the selection state is deprecated. + Use the following selection methods instead. - .. method:: selection_set(items) + + .. method:: selection_set(*items) *items* becomes the new selection. + .. versionchanged:: 3.6 + *items* can be passed as separate arguments, not just as a single tuple. + - .. method:: selection_add(items) + .. method:: selection_add(*items) Add *items* to the selection. + .. versionchanged:: 3.6 + *items* can be passed as separate arguments, not just as a single tuple. + - .. method:: selection_remove(items) + .. method:: selection_remove(*items) Remove *items* from the selection. + .. versionchanged:: 3.6 + *items* can be passed as separate arguments, not just as a single tuple. - .. method:: selection_toggle(items) + + .. method:: selection_toggle(*items) Toggle the selection state of each item in *items*. + .. versionchanged:: 3.6 + *items* can be passed as separate arguments, not just as a single tuple. + .. method:: set(item, column=None, value=None) |