diff --git a/kivy/uix/textinput.py b/kivy/uix/textinput.py index 72deb1222..74d8ae5b5 100644 --- a/kivy/uix/textinput.py +++ b/kivy/uix/textinput.py @@ -311,15 +311,15 @@ class TextInput(Widget): :meth:`on_quad_touch`. .. warning:: - When changing the a :class:`TextInput` parameter that requires - re-drawing, e.g. modifying :attr:`text`, the updates occur on the next + When changing a :class:`TextInput` property that requires re-drawing, + e.g. modifying the :attr:`text`, the updates occur on the next clock cycle and not instantly. This might cause any changes to the :class:`TextInput` that occur between the modification and the next - cycle to be ignored, or to use the previous values. For example, after - a update to :attr:`text`, changing the cursor in the same clock frame - will move it using the previous text and will likely end up in a + cycle to be ignored, or to use previous values. For example, after + a update to the :attr:`text`, changing the cursor in the same clock + frame will move it using the previous text and will likely end up in an incorrect position. The solution is to schedule any updates to occur - on the next clock cycle using e.g. + on the next clock cycle using :meth:`~kivy.clock.ClockBase.schedule_once`. .. versionchanged:: 1.7.0