Salome HOME
CCAR:ajout de l'aide EFICAS et desactivation modifications mots cles inconnus
[tools/eficas.git] / AIDE / aide_gui.py
1 """
2 Ce module génère l'IHM permettant d'accéder à l'aide en ligne d'une application(ex: EFICAS)
3 Il analyse l'objet index passé en argument et génére automatiquement en conséquence le menu
4 avec liens hyper texte
5 """
6
7 from Tkinter import *
8
9 class AIDE_GUI:
10    """
11    Classe définissant l'IHM de l'appli d'aide
12    """
13    def __init__(self,objet,master=None):
14       self.objet = objet
15       self.master = master
16       self.init()
17       self.init_window()
18       self.init_frames()
19       self.init_buttons()
20       self.init_text()
21       
22    def init(self):
23       """
24       Initialise les structures de données utlisées par l'objet
25       """
26       self.padx = [0,0,0,0]
27       self.padx[0] = 0
28       self.padx[1] = 30
29       self.padx[2] = 50
30       self.historique = []   
31       
32    def init_window(self):
33       """
34       Initialise la fenêtre mère de l'appli
35       """
36       fenetre = Toplevel()
37       if self.master :
38          self.fenetre = fenetre
39       else:
40          self.fenetre = fenetre.master
41          fenetre.destroy()
42       self.fenetre.title(self.objet.titre)
43       self.fenetre.geometry("700x700+50+50")
44       self.fenetre.resizable(1,1)
45       #self.fenetre.minsize(600,800)
46       #self.fenetre.maxsize(900,800)
47       self.fenetre.protocol("WM_DELETE_WINDOW",self.quit)
48       self.fenetre.update()
49          
50    def init_frames(self):
51       """
52       Initialise les frames principales de l'appli
53       """
54       self.frame1 = Frame(self.fenetre,relief='flat',bd=2)
55       self.frame2 = Frame(self.fenetre,relief='flat',bd=2)
56       self.frame1.grid(row=0,column=0,sticky='news')
57       self.frame2.grid(row=1,column=0,sticky='news')
58       self.fenetre.grid_columnconfigure(0,weight=1,minsize=0)
59       self.fenetre.grid_rowconfigure(1,minsize=30)
60       self.fenetre.grid_rowconfigure(0,weight=1,minsize=0)
61       
62    def init_buttons(self):
63       """
64       Crée les boutons dans le bas de la fenêtre
65       """
66       self.b_retour = Button(self.frame2,text = "Précédent",command=self.go_back)
67       self.b_retour.place(relx=0.33,rely=0.5,anchor='center')
68       Button(self.frame2,text="Fermer",command=self.quit).place(relx=0.66,rely=0.5,anchor='center') 
69       
70
71    def init_text(self):
72       """
73       Construit le widget Text qui accueillera l'index et les fichiers
74       """
75       self.scroll_v = Scrollbar(self.frame1)
76       self.scroll_v.grid(row=0,column=1,rowspan=2,sticky='nesw')
77       self.scroll_h = Scrollbar(self.frame1,orient='horizontal')
78       self.scroll_h.grid(row=1,column=0,rowspan=2,sticky='nesw')
79       self.canvas = Canvas(self.frame1,
80                            bg='white',
81                            relief='sunken',
82                            scrollregion=(0,0,1000,1000),
83                            yscrollcommand=self.scroll_v.set,
84                            xscrollcommand=self.scroll_h.set)
85       self.canvas.grid(row=0,column=0,sticky='nesw')
86       self.scroll_v.configure(command=self.canvas.yview)
87       self.scroll_h.configure(command=self.canvas.xview)
88       self.frame1.grid_columnconfigure(0,weight=1,minsize=0)
89       self.frame1.grid_rowconfigure(0,weight=1,minsize=0)
90       self.frame1.grid_rowconfigure(1,minsize=10)
91       self.frame1.grid_columnconfigure(1,minsize=10)
92
93    def build(self):
94       """
95       Lance la construction dynamique de l'index en hyper texte
96       """
97       self.frame1.update_idletasks()
98       largeur = self.frame1.winfo_width()
99       self.canvas.create_rectangle(0,0,1,1,outline='white')
100       self.y_courant = 0
101       # Construction du titre encadré d'une bordure
102       titre = self.canvas.create_text(int(largeur/2),50,anchor='center',text=self.objet.titre,font="Helvetica 12 bold")
103       bbox = self.canvas.bbox(titre)
104       bordure = self.canvas.create_rectangle(bbox[0]-5,bbox[1]-5,bbox[2]+5,bbox[3]+5,
105                                              outline = 'black',
106                                              fill = 'grey75')
107       self.canvas.lower(bordure)                                     
108       self.y_courant += 100
109       # Construction des items
110       for item in self.objet.l_items :
111           self.build_item(item,0)
112       # Affichage du texte dans le fichier associé (s'il existe)
113       if self.objet.fichier :
114          try:
115             texte=open(self.objet.fichier,'r').read()
116          except:
117             texte="Fichier %s inaccessible" % self.objet.fichier
118          self.canvas.create_text(10,self.y_courant+20,
119                                  text=texte,
120                                  anchor='nw')
121       # Configuration dynamique des boutons
122       self.config_boutons()
123       #
124       self.canvas.config(scrollregion=self.canvas.bbox('all'))
125       
126    def config_boutons(self):
127       """
128       Activation du bouton précédent s'il y a lieu
129       """
130       if self.historique : 
131          self.b_retour.config(state='normal')
132       else :
133          self.b_retour.config(state='disabled')
134       
135    def build_item(self,item,padx):
136       """
137       Affiche l'item dans le menu décalé de padx
138       """
139       l = Label(self.canvas,
140                 text=item.titre,
141                 foreground = 'blue',
142                 background='white',
143                 font="Helvetica 12 bold")
144       l.bind("<Button-1>",lambda e,s=self,o=item : s.update_objet(o))
145       l.bind("<Enter>",lambda e,s=self,o=l : s.select_label(o))
146       l.bind("<Leave>",lambda e,s=self,o=l : s.deselect_label(o))
147       self.canvas.create_window(self.padx[padx],self.y_courant,window=l,anchor='w')
148       self.y_courant += 20
149       for sub_item in item.l_items :
150           self.build_item(sub_item,padx+1)
151       
152    def show_file(self,fichier):
153       """
154       Affiche le fichier passé en argument
155       """
156       print "on veut afficher :",fichier
157
158    def select_label(self,label):
159       """
160       Callback invoqué lorsque le label passé en argument est sélectionné
161       """
162       label.config(fg='white',bg='blue')
163
164    def deselect_label(self,label):
165       """
166       Callback invoqué lorsque le label passé en argument est sélectionné
167       """
168       label.config(bg='white',fg='blue')      
169
170    def go_back(self):
171       """
172       Affiche l'item précédent
173       """
174       self.update_objet(self.historique[-1])
175       self.historique = self.historique[0:-1]
176       # Configuration dynamique des boutons
177       self.config_boutons()
178       
179    def update_objet(self,new_objet):
180       """
181       Cette méthode remplace l'objet courant par new_objet.
182       Elle vide le widget text et affiche le nouvel objet
183       """
184       if not self.historique : 
185          self.historique.append(self.objet)
186       elif new_objet is not self.historique[-1] :
187          self.historique.append(self.objet)
188       self.objet = new_objet 
189       self.canvas.delete('all')
190       self.build()
191                        
192    def quit(self):
193       """
194       Ferme l'appli Aide
195       """
196       self.fenetre.destroy()     
197       
198       
199       
200       
201       
202       
203       
204       
205       
206       
207       
208       
209       
210       
211       
212