File: enum_editor.py

package info (click to toggle)
python-traitsui 8.0.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 18,232 kB
  • sloc: python: 58,982; makefile: 113
file content (89 lines) | stat: -rw-r--r-- 3,014 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
# (C) Copyright 2004-2023 Enthought, Inc., Austin, TX
# All rights reserved.
#
# This software is provided without warranty under the terms of the BSD
# license included in LICENSE.txt and may be redistributed only under
# the conditions described in the aforementioned license. The license
# is also available online at http://www.enthought.com/licenses/BSD.txt
#
# Thanks for using Enthought open source!

""" Defines the editor factory for single-selection enumerations, for all
traits user interface toolkits.
"""

import os
import sys

from traits.api import Any, Range, Enum, Bool, Str

from traitsui.editor_factory import EditorWithListFactory
from traitsui.toolkit import toolkit_object

# -------------------------------------------------------------------------
#  Trait definitions:
# -------------------------------------------------------------------------

#: Supported display modes for a custom style editor
Mode = Enum("radio", "list")

#: Supported display modes for a custom style editor
CompletionMode = Enum("inline", "popup")


class EnumEditor(EditorWithListFactory):
    """Editor factory for enumeration editors."""

    # -------------------------------------------------------------------------
    #  Trait definitions:
    # -------------------------------------------------------------------------

    #: (Optional) Function used to evaluate text input:
    evaluate = Any()

    #: Is user input set on every keystroke (when text input is allowed)?
    auto_set = Bool(True)

    #: Number of columns to use when displayed as a grid:
    cols = Range(1, 20)

    #: Display modes supported for a custom style editor:
    mode = Mode

    #: Completion mode for editors with text-entry (Qt only):
    completion_mode = CompletionMode

    #: Whether values trait contains separators (Qt only)
    use_separator = Bool(False)

    #: The separator string used in values trait (Qt only)
    separator = Str("")

    # -------------------------------------------------------------------------
    #  'Editor' factory methods:
    # -------------------------------------------------------------------------

    def _get_custom_editor_class(self):
        """Returns the editor class to use for "custom" style views.
        Overridden to return the editor class for the specified mode.
        """
        editor_file_name = os.path.basename(
            sys.modules[self.__class__.__module__].__file__
        )
        try:
            if self.mode == "radio":
                return toolkit_object(
                    editor_file_name.split(".")[0] + ":RadioEditor",
                    raise_exceptions=True,
                )
            else:
                return toolkit_object(
                    editor_file_name.split(".")[0] + ":ListEditor",
                    raise_exceptions=True,
                )
        except:
            return super()._get_custom_editor_class()


# This alias is deprecated and will be removed in TraitsUI 8.
ToolkitEditorFactory = EnumEditor