/
view_menu_manager.py
149 lines (102 loc) · 4.68 KB
/
view_menu_manager.py
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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
# (C) Copyright 2005-2020 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!
""" The 'View' menu """
import logging
from pyface.action.api import Group, MenuManager
from traits.api import Any, Bool, Instance, List, Str
from traits.api import on_trait_change
from .perspective_menu_manager import PerspectiveMenuManager
from .show_view_action import ShowViewAction
from .toggle_view_visibility_action import ToggleViewVisibilityAction
# Logging.
logger = logging.getLogger(__name__)
class ViewMenuManager(MenuManager):
""" The 'View' menu.
By default, this menu is displayed on the main menu bar.
"""
# 'ActionManager' interface --------------------------------------------
# All of the groups in the manager.
groups = List(Group)
# The manager's unique identifier (if it has one).
id = Str("View")
# 'MenuManager' interface ---------------------------------------------#
# The menu manager's name (if the manager is a sub-menu, this is what its
# label will be).
name = Str("&View")
# 'ViewMenuManager' interface -----------------------------------------#
# Should the perspective menu be shown?
show_perspective_menu = Bool(True)
# The workbench window that the menu is part of.
window = Instance("pyface.workbench.api.WorkbenchWindow")
# 'Private' interface -------------------------------------------------#
# The group containing the view hide/show actions.
_view_group = Any()
# ------------------------------------------------------------------------
# 'ActionManager' interface.
# ------------------------------------------------------------------------
def _groups_default(self):
""" Trait initializer. """
groups = []
# Add a group containing the perspective menu (if requested).
if self.show_perspective_menu and len(self.window.perspectives) > 0:
groups.append(Group(PerspectiveMenuManager(window=self.window)))
# Add a group containing a 'toggler' for all visible views.
self._view_group = self._create_view_group(self.window)
groups.append(self._view_group)
# Add a group containing an 'Other...' item that will launch a dialog
# to allow the user to choose a view to show.
groups.append(self._create_other_group(self.window))
return groups
# ------------------------------------------------------------------------
# 'ViewMenuManager' interface.
# ------------------------------------------------------------------------
@on_trait_change(
"window.active_perspective,window.active_part,"
"window.views,window.views_items"
)
def refresh(self):
""" Refreshes the checked state of the actions in the menu. """
logger.debug("refreshing view menu")
if self._view_group is not None:
self._clear_group(self._view_group)
self._initialize_view_group(self.window, self._view_group)
self.changed = True
return
# ------------------------------------------------------------------------
# Private interface.
# ------------------------------------------------------------------------
def _clear_group(self, group):
""" Remove all items in a group. """
# fixme: Fix this API in Pyface so there is only one call!
group.destroy()
group.clear()
def _create_other_group(self, window):
""" Creates a group containing the 'Other...' action. """
group = Group()
group.append(ShowViewAction(name="Other...", window=window))
return group
def _create_view_group(self, window):
""" Creates a group containing the view 'togglers'. """
group = Group()
self._initialize_view_group(window, group)
return group
def _initialize_view_group(self, window, group):
""" Initializes a group containing the view 'togglers'. """
views = window.views[:]
views.sort(key=lambda view: view.name)
for view in views:
# fixme: It seems a little smelly to be reaching in to the window
# layout here. Should the 'contains_view' method be part of the
# window interface?
if window.layout.contains_view(view):
group.append(
ToggleViewVisibilityAction(view=view, window=window)
)
return