# # Gramps - a GTK+/GNOME based genealogy program # # Copyright (C) 2000-2006 Donald N. Allingham # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # # $Id:Assistant.py 9912 2008-01-22 09:17:46Z acraphae $ #------------------------------------------------------------------------- # # Standard python modules # #------------------------------------------------------------------------- from gen.ggettext import gettext as _ import os #------------------------------------------------------------------------- # # GTK modules # #------------------------------------------------------------------------- import gtk import gobject #------------------------------------------------------------------------- # # Gramps modules # #------------------------------------------------------------------------- import const import ManagedWindow #------------------------------------------------------------------------- # # Constants # #------------------------------------------------------------------------- _gramps_png = os.path.join(const.IMAGE_DIR, "gramps.png") _splash_jpg = os.path.join(const.IMAGE_DIR, "splash.jpg") _format = '%s' #------------------------------------------------------------------------- # # Assistant class # #------------------------------------------------------------------------- class Assistant(gtk.Object, ManagedWindow.ManagedWindow): """ A tabbed dialog box used to implement Assistant interfaces. Deprecated. Please use gtk.Assistant class from now on. See eg. example use in ExportAssistant """ __gproperties__ = {} __gsignals__ = { 'page-changed' : (gobject.SIGNAL_RUN_LAST, gobject.TYPE_NONE, (gobject.TYPE_INT, )), 'before-page-next' : (gobject.SIGNAL_RUN_LAST, gobject.TYPE_NONE, (gobject.TYPE_INT, )), 'after-page-next' : (gobject.SIGNAL_RUN_LAST, gobject.TYPE_NONE, (gobject.TYPE_INT, )), 'before-page-back' : (gobject.SIGNAL_RUN_LAST, gobject.TYPE_NONE, (gobject.TYPE_INT, )), 'after-page-back' : (gobject.SIGNAL_RUN_LAST, gobject.TYPE_NONE, (gobject.TYPE_INT, )), 'complete' : (gobject.SIGNAL_RUN_LAST, gobject.TYPE_NONE, ()) } def __init__(self, uistate, parent_class, complete, top_title=''): gobject.GObject.__init__(self) self.top_title = top_title if uistate: ManagedWindow.ManagedWindow.__init__(self, uistate, [], parent_class) else: self.uistate = None self.complete = complete self.fg_color = gtk.gdk.color_parse('#7d684a') self.bg_color = gtk.gdk.color_parse('#e1dbc5') self.logo = gtk.gdk.pixbuf_new_from_file(_gramps_png) self.splash = gtk.gdk.pixbuf_new_from_file(_splash_jpg) self.current_page = -1 if uistate: self.set_window(gtk.Window(), None, self.top_title) else: self.window = gtk.Window() self.close = self.destroy titlebox = gtk.HBox() self.title_text = [] self.title = gtk.Label('') self.title.set_alignment(0, 0.5) self.title.set_use_markup(True) titlebox.pack_start(self.title, True) image = gtk.Image() image.set_from_file(_gramps_png) titlebox.pack_end(image, False) self.notebook = gtk.Notebook() self.notebook.set_show_border(False) self.notebook.set_show_tabs(False) vbox = gtk.VBox(spacing=6) vbox.set_border_width(6) hbox = gtk.HButtonBox() hbox.set_spacing(6) hbox.set_layout(gtk.BUTTONBOX_END) self.cancel = gtk.Button(stock=gtk.STOCK_CANCEL) self.cancel.connect('clicked', self.close) self.back = gtk.Button(stock=gtk.STOCK_GO_BACK) self.back.set_sensitive(False) self.back.connect('clicked', self.back_clicked) self.next = gtk.Button(stock=gtk.STOCK_GO_FORWARD) self.next.connect('clicked', self.next_clicked) self.ok = gtk.Button(stock=gtk.STOCK_OK) self.ok.connect('clicked', self.next_clicked) self.ok.set_sensitive(False) hbox.add(self.cancel) hbox.add(self.back) hbox.add(self.next) hbox.add(self.ok) vbox.pack_start(titlebox, False) vbox.pack_start(self.notebook, True) vbox.pack_start(hbox, False) self.window.add(vbox) def build_menu_names(self, obj): return (self.top_title, None) def set_busy_cursor(self, value): if value: self.window.window.set_cursor(gtk.gdk.Cursor(gtk.gdk.WATCH)) self.window.set_sensitive(0) else: self.window.window.set_cursor(None) self.window.set_sensitive(1) while gtk.events_pending(): gtk.main_iteration() def destroy(self, *obj): self.window.emit('delete-event', None) self.window.destroy() def do_get_property(self, prop): """Return the gproperty's value.""" raise AttributeError, 'unknown property %s' % prop.name def do_set_property(self, prop, value): """Set the property of writable properties.""" raise AttributeError, 'unknown or read only property %s' % prop.name def get_number_of_pages(self): return self.notebook.get_n_pages() def update_title(self): self.title.set_label(self.title_text[self.current_page]) self.title.set_use_markup(True) def set_buttons(self): max_page = self.notebook.get_n_pages() if self.current_page == max_page-2: self.next.show() self.back.show() self.cancel.show() self.ok.set_sensitive(True) self.next.set_sensitive(False) self.back.set_sensitive(True) elif self.current_page == max_page-1: self.next.hide() self.back.hide() self.cancel.hide() elif self.current_page == 0: self.next.show() self.back.show() self.cancel.show() self.back.set_sensitive(False) self.next.set_sensitive(True) self.ok.set_sensitive(False) else: self.next.show() self.back.show() self.back.set_sensitive(True) self.next.set_sensitive(True) self.ok.set_sensitive(False) self.cancel.show() def back_clicked(self, obj): self.emit('before-page-back', self.notebook.get_current_page()) self.current_page -= 1 self.notebook.set_current_page(self.current_page) self.update_title() self.set_buttons() self.emit('after-page-back', self.notebook.get_current_page()) self.emit('page-changed', self.notebook.get_current_page()) def next_clicked(self, obj): self.emit('before-page-next', self.notebook.get_current_page()) if self.current_page == self.notebook.get_n_pages()-1: self.emit('complete') self.complete() self.close() else: self.current_page += 1 self.notebook.set_current_page(self.current_page) self.update_title() self.set_buttons() self.emit('after-page-next', self.notebook.get_current_page()) self.emit('page-changed', self.notebook.get_current_page()) def add_text_page(self, title, text): """ Add page with Gramps logo and given text and title. Usually, first page (introduction) and last page (conclusion) use this method. """ hbox = self.prepare_text_page(text) return self.add_page(title, hbox) def insert_text_page(self, title, text, position): """ Add page with Gramps logo and given text and title. Usually, first page (introduction) and last page (conclusion) use this method. """ hbox = self.prepare_text_page(text) return self.insert_page(title, hbox, position) def prepare_text_page(self, text): hbox = gtk.HBox(spacing=12) image = gtk.Image() image.set_from_file(_splash_jpg) hbox.pack_start(image, False) label = gtk.Label(text) label.set_line_wrap(True) label.set_use_markup(True) hbox.add(label) hbox.show_all() return hbox def add_page(self, title, child): """ Add page with the title and child widget. Return index number of the new page. """ self.title_text.append(_format % title) return self.notebook.append_page(child) def insert_page(self, title, child, position): """ Insert page at a given position. Returns index number of the new page. """ self.title_text.insert(position, _format % title) return self.notebook.insert_page(child, None, position) def remove_page(self, position): """ Remove page from a given position. """ self.title_text.pop(position) self.notebook.remove_page(position) def show(self): self.window.show_all() self.current_page = 0 self.notebook.set_current_page(self.current_page) self.update_title() self.set_buttons() self.emit('page-changed', self.notebook.get_current_page()) if self.uistate: ManagedWindow.ManagedWindow.show(self) if gtk.pygtk_version < (2, 8, 0): gobject.type_register(Assistant) if __name__ == "__main__": def complete(): gtk.main_quit() def make_label(table, val, y, x1, x2, x3, x4): label = gtk.Label(val) label.set_alignment(0, 0.5) text = gtk.Entry() table.attach(label, x1, x2, y, y+1, gtk.SHRINK|gtk.FILL) table.attach(text, x3, x4, y, y+1, gtk.EXPAND|gtk.FILL) return text a = Assistant(complete) a.add_text_page('Getting started', 'Welcome to Gramps, the Genealogical Research ' 'and Analysis Management Programming System.\n' 'Several options and information need to be gathered ' 'before Gramps is ready to be used. Any of this ' 'information can be changed in the future in the ' 'Preferences dialog under the Settings menu.') box = gtk.VBox() box.set_spacing(12) table = gtk.Table(8, 4) table.set_row_spacings(6) table.set_col_spacings(6) make_label(table, _('Name:'), 0, 0, 1, 1, 4) make_label(table, _('Address:'), 1, 0, 1, 1, 4) make_label(table, _('City:'), 2, 0, 1, 1, 2) make_label(table, _('State/Province:'), 2, 2, 3, 3, 4) make_label(table, _('Country:'), 3, 0, 1, 1, 2) make_label(table, _('ZIP/Postal code:'), 3, 2, 3, 3, 4) make_label(table, _('Phone:'), 4, 0, 1, 1, 4) make_label(table, _('Email:'), 5, 0, 1, 1, 4) box.add(table) a.add_page('Researcher information', box) a.add_text_page('Conclusion title', 'Very long conclusion text here') a.show() gtk.main()