Trying to make the delete buttons easier to hit
[ejpi] / src / hildonize.py
1 #!/usr/bin/env python
2
3 """
4 Open Issues
5         @bug Buttons are too small
6 """
7
8
9 import gobject
10 import gtk
11 import dbus
12
13
14 class _NullHildonModule(object):
15         pass
16
17
18 try:
19         import hildon as _hildon
20         hildon  = _hildon # Dumb but gets around pyflakiness
21 except (ImportError, OSError):
22         hildon = _NullHildonModule
23
24
25 IS_HILDON_SUPPORTED = hildon is not _NullHildonModule
26
27
28 class _NullHildonProgram(object):
29
30         def add_window(self, window):
31                 pass
32
33
34 def _hildon_get_app_class():
35         return hildon.Program
36
37
38 def _null_get_app_class():
39         return _NullHildonProgram
40
41
42 try:
43         hildon.Program
44         get_app_class = _hildon_get_app_class
45 except AttributeError:
46         get_app_class = _null_get_app_class
47
48
49 def _hildon_set_application_title(window, title):
50         pass
51
52
53 def _null_set_application_title(window, title):
54         window.set_title(title)
55
56
57 if IS_HILDON_SUPPORTED:
58         set_application_title = _hildon_set_application_title
59 else:
60         set_application_title = _null_set_application_title
61
62
63 def _fremantle_hildonize_window(app, window):
64         oldWindow = window
65         newWindow = hildon.StackableWindow()
66         oldWindow.get_child().reparent(newWindow)
67         app.add_window(newWindow)
68         return newWindow
69
70
71 def _hildon_hildonize_window(app, window):
72         oldWindow = window
73         newWindow = hildon.Window()
74         oldWindow.get_child().reparent(newWindow)
75         app.add_window(newWindow)
76         return newWindow
77
78
79 def _null_hildonize_window(app, window):
80         return window
81
82
83 try:
84         hildon.StackableWindow
85         hildonize_window = _fremantle_hildonize_window
86 except AttributeError:
87         try:
88                 hildon.Window
89                 hildonize_window = _hildon_hildonize_window
90         except AttributeError:
91                 hildonize_window = _null_hildonize_window
92
93
94 def _fremantle_hildonize_menu(window, gtkMenu, buttons):
95         appMenu = hildon.AppMenu()
96         for button in buttons:
97                 appMenu.append(button)
98         window.set_app_menu(appMenu)
99         gtkMenu.get_parent().remove(gtkMenu)
100         return appMenu
101
102
103 def _hildon_hildonize_menu(window, gtkMenu, ignoredButtons):
104         hildonMenu = gtk.Menu()
105         for child in gtkMenu.get_children():
106                 child.reparent(hildonMenu)
107         window.set_menu(hildonMenu)
108         gtkMenu.destroy()
109         return hildonMenu
110
111
112 def _null_hildonize_menu(window, gtkMenu, ignoredButtons):
113         return gtkMenu
114
115
116 try:
117         hildon.AppMenu
118         GTK_MENU_USED = False
119         IS_FREMANTLE_SUPPORTED = True
120         hildonize_menu = _fremantle_hildonize_menu
121 except AttributeError:
122         GTK_MENU_USED = True
123         IS_FREMANTLE_SUPPORTED = False
124         if IS_HILDON_SUPPORTED:
125                 hildonize_menu = _hildon_hildonize_menu
126         else:
127                 hildonize_menu = _null_hildonize_menu
128
129
130 def _hildon_set_button_auto_selectable(button):
131         button.set_theme_size(hildon.HILDON_SIZE_AUTO_HEIGHT)
132
133
134 def _null_set_button_auto_selectable(button):
135         pass
136
137
138 try:
139         hildon.HILDON_SIZE_AUTO_HEIGHT
140         gtk.Button.set_theme_size
141         set_button_auto_selectable = _hildon_set_button_auto_selectable
142 except AttributeError:
143         set_button_auto_selectable = _null_set_button_auto_selectable
144
145
146 def _hildon_set_button_finger_selectable(button):
147         button.set_theme_size(hildon.HILDON_SIZE_FINGER_HEIGHT)
148
149
150 def _null_set_button_finger_selectable(button):
151         pass
152
153
154 try:
155         hildon.HILDON_SIZE_FINGER_HEIGHT
156         gtk.Button.set_theme_size
157         set_button_finger_selectable = _hildon_set_button_finger_selectable
158 except AttributeError:
159         set_button_finger_selectable = _null_set_button_finger_selectable
160
161
162 def _hildon_set_button_thumb_selectable(button):
163         button.set_theme_size(hildon.HILDON_SIZE_THUMB_HEIGHT)
164
165
166 def _null_set_button_thumb_selectable(button):
167         pass
168
169
170 try:
171         hildon.HILDON_SIZE_THUMB_HEIGHT
172         gtk.Button.set_theme_size
173         set_button_thumb_selectable = _hildon_set_button_thumb_selectable
174 except AttributeError:
175         set_button_thumb_selectable = _null_set_button_thumb_selectable
176
177
178 def _hildon_set_cell_thumb_selectable(renderer):
179         renderer.set_property("scale", 1.5)
180
181
182 def _null_set_cell_thumb_selectable(renderer):
183         pass
184
185
186 if IS_HILDON_SUPPORTED:
187         set_cell_thumb_selectable = _hildon_set_cell_thumb_selectable
188 else:
189         set_cell_thumb_selectable = _null_set_cell_thumb_selectable
190
191
192 def _hildon_set_pix_cell_thumb_selectable(renderer):
193         renderer.set_property("stock-size", 48)
194
195
196 def _null_set_pix_cell_thumb_selectable(renderer):
197         pass
198
199
200 if IS_HILDON_SUPPORTED:
201         set_pix_cell_thumb_selectable = _hildon_set_pix_cell_thumb_selectable
202 else:
203         set_pix_cell_thumb_selectable = _null_set_pix_cell_thumb_selectable
204
205
206 def _fremantle_show_information_banner(parent, message):
207         hildon.hildon_banner_show_information(parent, "", message)
208
209
210 def _hildon_show_information_banner(parent, message):
211         hildon.hildon_banner_show_information(parent, None, message)
212
213
214 def _null_show_information_banner(parent, message):
215         pass
216
217
218 if IS_FREMANTLE_SUPPORTED:
219         show_information_banner = _fremantle_show_information_banner
220 else:
221         try:
222                 hildon.hildon_banner_show_information
223                 show_information_banner = _hildon_show_information_banner
224         except AttributeError:
225                 show_information_banner = _null_show_information_banner
226
227
228 def _fremantle_show_busy_banner_start(parent, message):
229         hildon.hildon_gtk_window_set_progress_indicator(parent, True)
230         return parent
231
232
233 def _fremantle_show_busy_banner_end(banner):
234         hildon.hildon_gtk_window_set_progress_indicator(banner, False)
235
236
237 def _hildon_show_busy_banner_start(parent, message):
238         return hildon.hildon_banner_show_animation(parent, None, message)
239
240
241 def _hildon_show_busy_banner_end(banner):
242         banner.destroy()
243
244
245 def _null_show_busy_banner_start(parent, message):
246         return None
247
248
249 def _null_show_busy_banner_end(banner):
250         assert banner is None
251
252
253 try:
254         hildon.hildon_gtk_window_set_progress_indicator
255         show_busy_banner_start = _fremantle_show_busy_banner_start
256         show_busy_banner_end = _fremantle_show_busy_banner_end
257 except AttributeError:
258         try:
259                 hildon.hildon_banner_show_animation
260                 show_busy_banner_start = _hildon_show_busy_banner_start
261                 show_busy_banner_end = _hildon_show_busy_banner_end
262         except AttributeError:
263                 show_busy_banner_start = _null_show_busy_banner_start
264                 show_busy_banner_end = _null_show_busy_banner_end
265
266
267 def _hildon_hildonize_text_entry(textEntry):
268         textEntry.set_property('hildon-input-mode', 7)
269
270
271 def _null_hildonize_text_entry(textEntry):
272         pass
273
274
275 if IS_HILDON_SUPPORTED:
276         hildonize_text_entry = _hildon_hildonize_text_entry
277 else:
278         hildonize_text_entry = _null_hildonize_text_entry
279
280
281 def _hildon_mark_window_rotatable(window):
282         # gtk documentation is unclear whether this does a "=" or a "|="
283         window.set_flags(hildon.HILDON_PORTRAIT_MODE_SUPPORT)
284
285
286 def _null_mark_window_rotatable(window):
287         pass
288
289
290 try:
291         hildon.HILDON_PORTRAIT_MODE_SUPPORT
292         mark_window_rotatable = _hildon_mark_window_rotatable
293 except AttributeError:
294         mark_window_rotatable = _null_mark_window_rotatable
295
296
297 def _hildon_window_to_portrait(window):
298         # gtk documentation is unclear whether this does a "=" or a "|="
299         window.set_flags(hildon.HILDON_PORTRAIT_MODE_SUPPORT)
300
301
302 def _hildon_window_to_landscape(window):
303         # gtk documentation is unclear whether this does a "=" or a "&= ~"
304         window.unset_flags(hildon.HILDON_PORTRAIT_MODE_REQUEST)
305
306
307 def _null_window_to_portrait(window):
308         pass
309
310
311 def _null_window_to_landscape(window):
312         pass
313
314
315 try:
316         hildon.HILDON_PORTRAIT_MODE_SUPPORT
317         hildon.HILDON_PORTRAIT_MODE_REQUEST
318
319         window_to_portrait = _hildon_window_to_portrait
320         window_to_landscape = _hildon_window_to_landscape
321 except AttributeError:
322         window_to_portrait = _null_window_to_portrait
323         window_to_landscape = _null_window_to_landscape
324
325
326 def get_device_orientation():
327         bus = dbus.SystemBus()
328         try:
329                 rawMceRequest = bus.get_object("com.nokia.mce", "/com/nokia/mce/request")
330                 mceRequest = dbus.Interface(rawMceRequest, dbus_interface="com.nokia.mce.request")
331                 orientation, standState, faceState, xAxis, yAxis, zAxis = mceRequest.get_device_orientation()
332         except dbus.exception.DBusException:
333                 # catching for documentation purposes that when a system doesn't
334                 # support this, this is what to expect
335                 raise
336
337         if orientation == "":
338                 return gtk.ORIENTATION_HORIZONTAL
339         elif orientation == "":
340                 return gtk.ORIENTATION_VERTICAL
341         else:
342                 raise RuntimeError("Unknown orientation: %s" % orientation)
343
344
345 def _hildon_hildonize_password_entry(textEntry):
346         textEntry.set_property('hildon-input-mode', 7 | (1 << 29))
347
348
349 def _null_hildonize_password_entry(textEntry):
350         pass
351
352
353 if IS_HILDON_SUPPORTED:
354         hildonize_password_entry = _hildon_hildonize_password_entry
355 else:
356         hildonize_password_entry = _null_hildonize_password_entry
357
358
359 def _hildon_hildonize_combo_entry(comboEntry):
360         comboEntry.set_property('hildon-input-mode', 1 << 4)
361
362
363 def _null_hildonize_combo_entry(textEntry):
364         pass
365
366
367 if IS_HILDON_SUPPORTED:
368         hildonize_combo_entry = _hildon_hildonize_combo_entry
369 else:
370         hildonize_combo_entry = _null_hildonize_combo_entry
371
372
373 def _fremantle_hildonize_scrollwindow(scrolledWindow):
374         pannableWindow = hildon.PannableArea()
375
376         child = scrolledWindow.get_child()
377         scrolledWindow.remove(child)
378         pannableWindow.add(child)
379
380         parent = scrolledWindow.get_parent()
381         parent.remove(scrolledWindow)
382         parent.add(pannableWindow)
383
384         return pannableWindow
385
386
387 def _hildon_hildonize_scrollwindow(scrolledWindow):
388         hildon.hildon_helper_set_thumb_scrollbar(scrolledWindow, True)
389         return scrolledWindow
390
391
392 def _null_hildonize_scrollwindow(scrolledWindow):
393         return scrolledWindow
394
395
396 try:
397         hildon.PannableArea
398         hildonize_scrollwindow = _fremantle_hildonize_scrollwindow
399         hildonize_scrollwindow_with_viewport = _hildon_hildonize_scrollwindow
400 except AttributeError:
401         try:
402                 hildon.hildon_helper_set_thumb_scrollbar
403                 hildonize_scrollwindow = _hildon_hildonize_scrollwindow
404                 hildonize_scrollwindow_with_viewport = _hildon_hildonize_scrollwindow
405         except AttributeError:
406                 hildonize_scrollwindow = _null_hildonize_scrollwindow
407                 hildonize_scrollwindow_with_viewport = _null_hildonize_scrollwindow
408
409
410 def _hildon_request_number(parent, title, range, default):
411         spinner = hildon.NumberEditor(*range)
412         spinner.set_value(default)
413
414         dialog = gtk.Dialog(
415                 title,
416                 parent,
417                 gtk.DIALOG_MODAL|gtk.DIALOG_DESTROY_WITH_PARENT,
418                 (gtk.STOCK_OK, gtk.RESPONSE_OK, gtk.STOCK_CANCEL, gtk.RESPONSE_CANCEL),
419         )
420         dialog.set_default_response(gtk.RESPONSE_CANCEL)
421         dialog.get_child().add(spinner)
422
423         try:
424                 dialog.show_all()
425                 response = dialog.run()
426
427                 if response == gtk.RESPONSE_OK:
428                         return spinner.get_value()
429                 elif response == gtk.RESPONSE_CANCEL or response == gtk.RESPONSE_DELETE_EVENT:
430                         raise RuntimeError("User cancelled request")
431                 else:
432                         raise RuntimeError("Unrecognized response %r", response)
433         finally:
434                 dialog.hide()
435                 dialog.destroy()
436
437
438 def _null_request_number(parent, title, range, default):
439         adjustment = gtk.Adjustment(default, range[0], range[1], 1, 5, 0)
440         spinner = gtk.SpinButton(adjustment, 0, 0)
441         spinner.set_wrap(False)
442
443         dialog = gtk.Dialog(
444                 title,
445                 parent,
446                 gtk.DIALOG_MODAL|gtk.DIALOG_DESTROY_WITH_PARENT,
447                 (gtk.STOCK_OK, gtk.RESPONSE_OK, gtk.STOCK_CANCEL, gtk.RESPONSE_CANCEL),
448         )
449         dialog.set_default_response(gtk.RESPONSE_CANCEL)
450         dialog.get_child().add(spinner)
451
452         try:
453                 dialog.show_all()
454                 response = dialog.run()
455
456                 if response == gtk.RESPONSE_OK:
457                         return spinner.get_value_as_int()
458                 elif response == gtk.RESPONSE_CANCEL or response == gtk.RESPONSE_DELETE_EVENT:
459                         raise RuntimeError("User cancelled request")
460                 else:
461                         raise RuntimeError("Unrecognized response %r", response)
462         finally:
463                 dialog.hide()
464                 dialog.destroy()
465
466
467 try:
468         hildon.NumberEditor # TODO deprecated in fremantle
469         request_number = _hildon_request_number
470 except AttributeError:
471         request_number = _null_request_number
472
473
474 def _hildon_touch_selector(parent, title, items, defaultIndex):
475         model = gtk.ListStore(gobject.TYPE_STRING)
476         for item in items:
477                 model.append((item, ))
478
479         selector = hildon.TouchSelector()
480         selector.append_text_column(model, True)
481         selector.set_column_selection_mode(hildon.TOUCH_SELECTOR_SELECTION_MODE_SINGLE)
482         selector.set_active(0, defaultIndex)
483
484         dialog = hildon.PickerDialog(parent)
485         dialog.set_selector(selector)
486
487         try:
488                 dialog.show_all()
489                 response = dialog.run()
490
491                 if response == gtk.RESPONSE_OK:
492                         return selector.get_active(0)
493                 elif response == gtk.RESPONSE_CANCEL or response == gtk.RESPONSE_DELETE_EVENT:
494                         raise RuntimeError("User cancelled request")
495                 else:
496                         raise RuntimeError("Unrecognized response %r", response)
497         finally:
498                 dialog.hide()
499                 dialog.destroy()
500
501
502 def _on_null_touch_selector_activated(treeView, path, column, dialog, pathData):
503         dialog.response(gtk.RESPONSE_OK)
504         pathData[0] = path
505
506
507 def _null_touch_selector(parent, title, items, defaultIndex = -1):
508         parentSize = parent.get_size()
509
510         model = gtk.ListStore(gobject.TYPE_STRING)
511         for item in items:
512                 model.append((item, ))
513
514         cell = gtk.CellRendererText()
515         set_cell_thumb_selectable(cell)
516         column = gtk.TreeViewColumn(title)
517         column.pack_start(cell, expand=True)
518         column.add_attribute(cell, "text", 0)
519
520         treeView = gtk.TreeView()
521         treeView.set_model(model)
522         treeView.append_column(column)
523         selection = treeView.get_selection()
524         selection.set_mode(gtk.SELECTION_SINGLE)
525         if 0 < defaultIndex:
526                 selection.select_path((defaultIndex, ))
527
528         scrolledWin = gtk.ScrolledWindow()
529         scrolledWin.set_policy(gtk.POLICY_AUTOMATIC, gtk.POLICY_AUTOMATIC)
530         scrolledWin.add(treeView)
531
532         dialog = gtk.Dialog(
533                 title,
534                 parent,
535                 gtk.DIALOG_MODAL|gtk.DIALOG_DESTROY_WITH_PARENT,
536                 (gtk.STOCK_CANCEL, gtk.RESPONSE_CANCEL),
537         )
538         dialog.set_default_response(gtk.RESPONSE_CANCEL)
539         dialog.get_child().add(scrolledWin)
540         dialog.resize(parentSize[0], max(parentSize[1]-100, 100))
541
542         scrolledWin = hildonize_scrollwindow(scrolledWin)
543         pathData = [None]
544         treeView.connect("row-activated", _on_null_touch_selector_activated, dialog, pathData)
545
546         try:
547                 dialog.show_all()
548                 response = dialog.run()
549
550                 if response == gtk.RESPONSE_OK:
551                         if pathData[0] is None:
552                                 raise RuntimeError("No selection made")
553                         return pathData[0][0]
554                 elif response == gtk.RESPONSE_CANCEL or response == gtk.RESPONSE_DELETE_EVENT:
555                         raise RuntimeError("User cancelled request")
556                 else:
557                         raise RuntimeError("Unrecognized response %r", response)
558         finally:
559                 dialog.hide()
560                 dialog.destroy()
561
562
563 try:
564         hildon.PickerDialog
565         hildon.TouchSelector
566         touch_selector = _hildon_touch_selector
567 except AttributeError:
568         touch_selector = _null_touch_selector
569
570
571 def _hildon_touch_selector_entry(parent, title, items, defaultItem):
572         # Got a segfault when using append_text_column with TouchSelectorEntry, so using this way
573         try:
574                 selector = hildon.TouchSelectorEntry(text=True)
575         except TypeError:
576                 selector = hildon.hildon_touch_selector_entry_new_text()
577         defaultIndex = -1
578         for i, item in enumerate(items):
579                 selector.append_text(item)
580                 if item == defaultItem:
581                         defaultIndex = i
582
583         dialog = hildon.PickerDialog(parent)
584         dialog.set_selector(selector)
585
586         if 0 < defaultIndex:
587                 selector.set_active(0, defaultIndex)
588         else:
589                 selector.get_entry().set_text(defaultItem)
590
591         try:
592                 dialog.show_all()
593                 response = dialog.run()
594         finally:
595                 dialog.hide()
596
597         if response == gtk.RESPONSE_OK:
598                 return selector.get_entry().get_text()
599         elif response == gtk.RESPONSE_CANCEL or response == gtk.RESPONSE_DELETE_EVENT:
600                 raise RuntimeError("User cancelled request")
601         else:
602                 raise RuntimeError("Unrecognized response %r", response)
603
604
605 def _on_null_touch_selector_entry_entry_changed(entry, result, selection, defaultIndex):
606         custom = entry.get_text().strip()
607         if custom:
608                 result[0] = custom
609                 selection.unselect_all()
610         else:
611                 result[0] = None
612                 selection.select_path((defaultIndex, ))
613
614
615 def _on_null_touch_selector_entry_entry_activated(customEntry, dialog, result):
616         dialog.response(gtk.RESPONSE_OK)
617         result[0] = customEntry.get_text()
618
619
620 def _on_null_touch_selector_entry_tree_activated(treeView, path, column, dialog, result):
621         dialog.response(gtk.RESPONSE_OK)
622         model = treeView.get_model()
623         itr = model.get_iter(path)
624         if itr is not None:
625                 result[0] = model.get_value(itr, 0)
626
627
628 def _null_touch_selector_entry(parent, title, items, defaultItem):
629         parentSize = parent.get_size()
630
631         model = gtk.ListStore(gobject.TYPE_STRING)
632         defaultIndex = -1
633         for i, item in enumerate(items):
634                 model.append((item, ))
635                 if item == defaultItem:
636                         defaultIndex = i
637
638         cell = gtk.CellRendererText()
639         set_cell_thumb_selectable(cell)
640         column = gtk.TreeViewColumn(title)
641         column.pack_start(cell, expand=True)
642         column.add_attribute(cell, "text", 0)
643
644         treeView = gtk.TreeView()
645         treeView.set_model(model)
646         treeView.append_column(column)
647         selection = treeView.get_selection()
648         selection.set_mode(gtk.SELECTION_SINGLE)
649
650         scrolledWin = gtk.ScrolledWindow()
651         scrolledWin.set_policy(gtk.POLICY_AUTOMATIC, gtk.POLICY_AUTOMATIC)
652         scrolledWin.add(treeView)
653
654         customEntry = gtk.Entry()
655
656         layout = gtk.VBox()
657         layout.pack_start(customEntry, expand=False)
658         layout.pack_start(scrolledWin)
659
660         dialog = gtk.Dialog(
661                 title,
662                 parent,
663                 gtk.DIALOG_MODAL|gtk.DIALOG_DESTROY_WITH_PARENT,
664                 (gtk.STOCK_OK, gtk.RESPONSE_OK, gtk.STOCK_CANCEL, gtk.RESPONSE_CANCEL),
665         )
666         dialog.set_default_response(gtk.RESPONSE_CANCEL)
667         dialog.get_child().add(layout)
668         dialog.resize(parentSize[0], max(parentSize[1]-100, 100))
669
670         scrolledWin = hildonize_scrollwindow(scrolledWin)
671
672         result = [None]
673         if 0 < defaultIndex:
674                 selection.select_path((defaultIndex, ))
675                 result[0] = defaultItem
676         else:
677                 customEntry.set_text(defaultItem)
678
679         customEntry.connect("activate", _on_null_touch_selector_entry_entry_activated, dialog, result)
680         customEntry.connect("changed", _on_null_touch_selector_entry_entry_changed, result, selection, defaultIndex)
681         treeView.connect("row-activated", _on_null_touch_selector_entry_tree_activated, dialog, result)
682
683         try:
684                 dialog.show_all()
685                 response = dialog.run()
686
687                 if response == gtk.RESPONSE_OK:
688                         _, itr = selection.get_selected()
689                         if itr is not None:
690                                 return model.get_value(itr, 0)
691                         else:
692                                 enteredText = customEntry.get_text().strip()
693                                 if enteredText:
694                                         return enteredText
695                                 elif result[0] is not None:
696                                         return result[0]
697                                 else:
698                                         raise RuntimeError("No selection made")
699                 elif response == gtk.RESPONSE_CANCEL or response == gtk.RESPONSE_DELETE_EVENT:
700                         raise RuntimeError("User cancelled request")
701                 else:
702                         raise RuntimeError("Unrecognized response %r", response)
703         finally:
704                 dialog.hide()
705                 dialog.destroy()
706
707
708 try:
709         hildon.PickerDialog
710         hildon.TouchSelectorEntry
711         touch_selector_entry = _hildon_touch_selector_entry
712 except AttributeError:
713         touch_selector_entry = _null_touch_selector_entry
714
715
716 if __name__ == "__main__":
717         app = get_app_class()()
718
719         label = gtk.Label("Hello World from a Label!")
720
721         win = gtk.Window()
722         win.add(label)
723         win = hildonize_window(app, win)
724         if False:
725                 print touch_selector(win, "Test", ["A", "B", "C", "D"], 2)
726         if True:
727                 print touch_selector_entry(win, "Test", ["A", "B", "C", "D"], "C")
728                 print touch_selector_entry(win, "Test", ["A", "B", "C", "D"], "Blah")
729         if False:
730                 import pprint
731                 name, value = "", ""
732                 goodLocals = [
733                         (name, value) for (name, value) in locals().iteritems()
734                         if not name.startswith("_")
735                 ]
736                 pprint.pprint(goodLocals)
737         if False:
738                 import time
739                 show_information_banner(win, "Hello World")
740                 time.sleep(5)
741         if False:
742                 import time
743                 banner = show_busy_banner_start(win, "Hello World")
744                 time.sleep(5)
745                 show_busy_banner_end(banner)