Source code for pyface.tasks.action.task_window_toggle_group
# (C) Copyright 2005-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!
from traits.api import Any, Instance, List, Property, Str, observe
from pyface.action.api import Action, Group
[docs]class TaskWindowToggleAction(Action):
""" An action for activating an application window.
"""
# 'Action' interface -----------------------------------------------------
#: The name of the action for the window.
name = Property(Str, observe="window.title")
#: The action is a toggle action.
style = "toggle"
# 'TaskWindowToggleAction' interface -------------------------------------
#: The window to use for this action.
window = Instance("pyface.tasks.task_window.TaskWindow")
# -------------------------------------------------------------------------
# 'Action' interface.
# -------------------------------------------------------------------------
# -------------------------------------------------------------------------
# Private interface.
# -------------------------------------------------------------------------
def _get_name(self):
if self.window.title:
return self.window.title
return ""
@observe("window:activated")
def _window_activated(self, event):
self.checked = True
@observe("window:deactivated")
def _window_deactivated(self, event):
self.checked = False
[docs]class TaskWindowToggleGroup(Group):
""" A Group for toggling the activation state of an application's windows.
"""
# 'Group' interface ------------------------------------------------------
#: The id of the action group.
id = "TaskWindowToggleGroup"
#: The actions in the action group
items = List()
# 'TaskWindowToggleGroup' interface --------------------------------------
#: The application that contains the group.
application = Instance("pyface.tasks.tasks_application.TasksApplication")
#: The ActionManager to which the group belongs.
manager = Any()
# -------------------------------------------------------------------------
# 'Group' interface.
# -------------------------------------------------------------------------
[docs] def destroy(self):
""" Called when the group is no longer required.
"""
super().destroy()
if self.application:
self.application.observe(
self._rebuild, "windows.items", remove=True
)
# -------------------------------------------------------------------------
# Private interface.
# -------------------------------------------------------------------------
def _get_items(self):
from pyface.action.action_item import ActionItem
items = []
for window in self.application.windows:
active = window == self.application.active_window
action = TaskWindowToggleAction(window=window, checked=active)
items.append(ActionItem(action=action))
return items
def _rebuild(self, event):
# Clear out the old group, then build the new one.
for item in self.items:
item.destroy()
self.items = self._get_items()
# Inform our manager that it needs to be rebuilt.
self.manager.changed = True
# Trait initializers -----------------------------------------------------
def _items_default(self):
self.application.observe(self._rebuild, "windows.items")
return self._get_items()
def _manager_default(self):
manager = self
while isinstance(manager, Group):
manager = manager.parent
return manager