Add warning about ListItemButton gotcha.

This commit is contained in:
Ian Foote 2013-06-22 12:48:54 +01:00
parent 4dd31aa460
commit be5e2966e9
1 changed files with 6 additions and 0 deletions

View File

@ -283,6 +283,12 @@ either a cls or template.
ListItemLabel and ListItemButton, or custom classes like them, and not the ListItemLabel and ListItemButton, or custom classes like them, and not the
bare Label nor Button classes, are to be used in the listview system. bare Label nor Button classes, are to be used in the listview system.
.. warning::
ListItemButton inherits the `background_normal` and `background_down`
properties from the Button widget, so the `selected_color` and
`deselected_color` are not represented faithfully by default.
Here is an args_converter for use with the built-in Here is an args_converter for use with the built-in
:class:`~kivy.uix.listview.ListItemButton`, specified as a normal Python :class:`~kivy.uix.listview.ListItemButton`, specified as a normal Python
function:: function::