# # 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$ #------------------------------------------------------------------------- # # Standard python modules # #------------------------------------------------------------------------- from gettext import gettext as _ import os #------------------------------------------------------------------------- # # set up logging # #------------------------------------------------------------------------- import logging log = logging.getLogger(".Assistant") #------------------------------------------------------------------------- # # GTK modules # #------------------------------------------------------------------------- import gtk import gtk.gdk 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.""" __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,complete,top_title=''): gobject.GObject.__init__(self) self.top_title = top_title if uistate: ManagedWindow.ManagedWindow.__init__(self,uistate,[], self.__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.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) hbox.add(label) hbox.show_all() return hbox def add_page(self, title, child): """ Add page with the title and child widget. Returns 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()