9 |
|
|
10 |
__version__ = "$Revision$" |
__version__ = "$Revision$" |
11 |
|
|
12 |
|
from Thuban import _ |
13 |
|
|
14 |
class Menu: |
class Menu: |
15 |
|
|
42 |
def item_index(self, item): |
def item_index(self, item): |
43 |
"""Return the index of item in the menu. |
"""Return the index of item in the menu. |
44 |
|
|
45 |
|
item -- may be the name of a non-menu entry or the |
46 |
|
name of a menu or a menu itself. |
47 |
|
|
48 |
Return None it item is not found. |
Return None it item is not found. |
49 |
""" |
""" |
50 |
try: |
for i in range(len(self.items)): |
51 |
return self.items.index(item) |
temp = self.items[i] |
52 |
except ValueError: |
if temp == item: |
53 |
return None |
# this case takes care of item being the name of an |
54 |
|
# entry or a menu. |
55 |
|
return i |
56 |
|
elif isinstance(temp, Menu) and temp.name == item: |
57 |
|
# item is the name of a menu |
58 |
|
return i |
59 |
|
# Didn't find the item so return None |
60 |
|
return None |
61 |
|
|
62 |
def find_menu(self, name): |
def find_menu(self, name): |
63 |
"""Return the submenu named name or None if no such item exists""" |
"""Return the submenu named name or None if no such item exists""" |
70 |
"""Insert a menu item. |
"""Insert a menu item. |
71 |
|
|
72 |
Parameters: |
Parameters: |
73 |
|
|
74 |
item -- the menu item to insert must be either a string with |
item -- the menu item to insert must be either a string with |
75 |
the command's name or a Menu instance. |
the command's name or a Menu instance. |
76 |
|
|
77 |
menu -- (optional) the submenu to insert into. It should be a |
menu -- (optional) the submenu to insert into. It should be a |
78 |
sequence of menu names. |
sequence of menu names. |
79 |
|
|
80 |
after -- (optional) insert the new item after this one. after |
after -- (optional) insert the new item after this one. after |
81 |
should be the name of a command. |
should be the name of a command. |
82 |
""" |
""" |
87 |
submenu_index.InsertItem(item, menu = menu[1:], after = after) |
submenu_index.InsertItem(item, menu = menu[1:], after = after) |
88 |
else: |
else: |
89 |
# the submenu doesn't exist yet. Raise an error. |
# the submenu doesn't exist yet. Raise an error. |
90 |
raise KeyError("Submenu %s doesn't exist" % menu[0]) |
raise KeyError(_("Submenu %s doesn't exist") % menu[0]) |
91 |
else: |
else: |
92 |
if after is not None: |
if after is not None: |
93 |
idx = self.item_index(after) |
idx = self.item_index(after) |
95 |
idx = None |
idx = None |
96 |
|
|
97 |
if idx is not None: |
if idx is not None: |
98 |
self.items.insert(idx + 1, item) |
self.items.insert(idx + 1, item) |
99 |
else: |
else: |
100 |
self.items.append(item) |
self.items.append(item) |
101 |
|
|
102 |
def InsertSeparator(self): |
def InsertSeparator(self, after = None): |
103 |
"""Insert a separator""" |
"""Insert a separator |
104 |
self.InsertItem(None) |
|
105 |
|
after -- (optional) insert the separator after this one. after |
106 |
|
should be the name of a command. |
107 |
|
""" |
108 |
|
self.InsertItem(None, after = after) |
109 |
|
|
110 |
def InsertMenu(self, name, title, menu = (), after = None): |
def InsertMenu(self, name, title, menu = (), after = None): |
111 |
"""Insert and return a new menu. |
"""Insert and return a new menu. |
115 |
name -- the (internal) name of the menu |
name -- the (internal) name of the menu |
116 |
|
|
117 |
title -- the (possibly localized) title |
title -- the (possibly localized) title |
118 |
|
|
119 |
menu -- (optional) the submenu to insert into. It should be a |
menu -- (optional) the submenu to insert into. It should be a |
120 |
sequence of menu names. |
sequence of menu names. |
121 |
|
|
122 |
after -- (optional) insert the new item after this one. after |
after -- (optional) insert the new item after this one. after |
123 |
should be the name of a command. |
should be the name of a command. |
124 |
""" |
""" |
126 |
self.InsertItem(newmenu, menu = menu, after = after) |
self.InsertItem(newmenu, menu = menu, after = after) |
127 |
return newmenu |
return newmenu |
128 |
|
|
129 |
|
def FindOrInsertMenu(self, name, title, menu = (), after = None): |
130 |
|
""" |
131 |
|
Find the menu with the specified name. If found, return it. |
132 |
|
Else insert the menu as specified and return it. |
133 |
|
|
134 |
|
Parameters: See InsertMenu(). |
135 |
|
""" |
136 |
|
|
137 |
|
m = self.find_menu(name) |
138 |
|
if m is None: |
139 |
|
m = self.InsertMenu(name, title, menu, after) |
140 |
|
return m |
141 |
|
|
142 |
|
|
143 |
def SetItems(self, items): |
def SetItems(self, items): |
144 |
"""Replace the contents of the menu by items.""" |
"""Replace the contents of the menu by items.""" |
145 |
self.items = items |
self.items = items |
146 |
|
|
147 |
|
def RemoveItem(self, item): |
148 |
|
"""Remove an item from the menu. |
149 |
|
|
150 |
|
item -- the (internal) name of the item. |
151 |
|
""" |
152 |
|
i = self.item_index(item) |
153 |
|
if i is not None: |
154 |
|
self.items.pop(i) |