Source code for enamlnative.widgets.auto_complete_text_view

"""
Copyright (c) 2017-2022, CodeLV.

Distributed under the terms of the MIT License.

The full license is in the file LICENSE, distributed with this software.

Created on May 20, 2017

 
"""
from atom.api import ForwardTyped, Int, List, Typed
from enaml.core.declarative import d_, observe
from .edit_text import EditText, ProxyEditText


class ProxyAutoCompleteTextView(ProxyEditText):
    """The abstract definition of a proxy AutoCompleteTextView object."""

    #: A reference to the Label declaration.
    declaration = ForwardTyped(lambda: AutoCompleteTextView)

    def set_choices(self, choices: list):
        raise NotImplementedError

    def set_drop_down_height(self, height: int):
        raise NotImplementedError

    def set_drop_down_width(self, width: int):
        raise NotImplementedError

    def set_list_selection(self, index: int):
        raise NotImplementedError

    def set_threshold(self, threshold: int):
        raise NotImplementedError


[docs]class AutoCompleteTextView(EditText):
    """A simple control for displaying read-only text."""

    #: Auto complete choices
    choices = d_(List())

    #: Sets the current height for the auto-complete drop down list.
    drop_down_height = d_(Int())

    #: Sets the current width for the auto-complete drop down list.
    drop_down_width = d_(Int())

    #: Selected item within the list
    list_selection = d_(Int())

    #: Specifies the minimum number of characters the user has to type
    #: in the edit box before the drop down list is shown.
    threshold = d_(Int())

    #: A reference to the ProxyLabel object.
    proxy = Typed(ProxyAutoCompleteTextView)

    @observe(
        "choices",
        "drop_down_height",
        "drop_down_width",
        "list_selection",
        "threshold",
    )
    def _update_proxy(self, change):

        super()._update_proxy(change)