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
|
#-------------------------------------------------------------------------------
#
# Adds a 'popup_menu' feature to DockWindow which will display a popup menu
# defined by an object when the user clicks on the feature image. The
# associated object must have a 'popup_menu' attribute, which can either
# be a menu or a function which returns a menu.
#
# Written by: David C. Morrill
#
# Date: 07/05/2006
#
# (c) Copyright 2006 by David C. Morrill
#
#-------------------------------------------------------------------------------
#-------------------------------------------------------------------------------
# Imports:
#-------------------------------------------------------------------------------
from enthought.traits.ui.menu \
import Menu, Action
from enthought.pyface.dock.api \
import DockWindowFeature
from enthought.pyface.image_resource \
import ImageResource
#-------------------------------------------------------------------------------
# Constants:
#-------------------------------------------------------------------------------
# Menu to display when there is no valid menu defined:
no_menu = Menu(
Action( name = 'No menu available',
enabled = False ),
name = 'popup'
)
#-------------------------------------------------------------------------------
# 'PopupMenuFeature' class:
#-------------------------------------------------------------------------------
class PopupMenuFeature ( DockWindowFeature ):
#---------------------------------------------------------------------------
# Class variables:
#---------------------------------------------------------------------------
# The user interface name of the feature:
feature_name = 'Popup Menu'
#---------------------------------------------------------------------------
# Trait definitions:
#---------------------------------------------------------------------------
# The current image to display on the feature bar:
image = ImageResource( 'popup_menu_feature' )
# The tooltip to display when the mouse is hovering over the image:
tooltip = 'Click to display the menu.'
#---------------------------------------------------------------------------
# Handles the user left clicking on the feature image:
#---------------------------------------------------------------------------
def click ( self ):
""" Handles the user left clicking on the feature image.
"""
object = self.dock_control.object
menu = object.popup_menu
if not isinstance( menu, Menu ):
try:
# It might be a method which returns a menu:
menu = menu()
except:
pass
if not isinstance( menu, Menu ):
menu = no_menu
self.popup_menu( menu )
#-- Overidable Class Methods ---------------------------------------------------
#---------------------------------------------------------------------------
# Returns whether or not the DockWindowFeature is a valid feature for a
# specified DockControl:
#---------------------------------------------------------------------------
def is_feature_for ( self, dock_control ):
""" Returns whether or not the DockWindowFeature is a valid feature for
a specified DockControl.
"""
object = dock_control.object
return ((object is not None) and hasattr( object, 'popup_menu' ))
is_feature_for = classmethod( is_feature_for )
|
