9.2 Callbacks

Will man eine eigene Benutzerschnittstelle schreiben, muessen die in gui.h deklarierten Funktionen angeboten werden. Diese werden vom Modul udo.c aufgerufen.

• show_status_* ( ... )
  Es sollen Statusinformationen ausgegeben werden, falls be_quiet==FALSE ist. UDO gibt Zeichenketten aus, in denen man den aktuellen Stand der Konvertierung anlesen kann.
   
• void warning_err_logfile ( void )
  Es wird eine Fehlermeldung ausgegeben, dass das Logfile nicht angelegt werden konnte.
   
  Hier kann man eine Dialogbox oeffnen oder aber die in msg.c angebotene Funktion error_open_logfile() verwenden.
   
  Der Name des Logfiles befindet sich in logfull.
   
• void warning_err_treefile ( void )
  Es wird eine Fehlermeldung ausgegeben, dass das Treefile nicht angelegt werden konnte. Ins Treefile wird ein "include"-Baum ausgegeben.
   
  Hier kann man eine Dialogbox oeffnen oder aber die in msg.c angebotene Funktion error_open_treefile() verwenden.
   
  Der Name des Treefiles befindet sich in treefull.
   
• void warning_err_hypfile ( void )
  Es wird eine Fehlermeldung ausgegeben, dass das Hyphenfile nicht angelegt werden konnte. In diese Datei gelangen die Trennvorschlaege fuer die ASCII-Formate.
   
  Hier kann man eine Dialogbox oeffnen oder aber die in msg.c angebotene Funktion error_open_hypfile() verwenden.
   
  Der Name des Hyphenfiles befindet sich in hypfull.
   
• void warning_err_destination ( void )
  Es wird eine Fehlermeldung ausgegeben, dass die Zieldatei nicht angelegt werden konnte.
   
• void multitasking_interrupt ( void )
  Diese Routine wird aufgerufen, um bei kooperativem Multitasking andere Prozesse zum Zug kommen zu lassen. Bei der GEM-Version werden z.B. an dieser Stelle Events bearbeitet, die zwischendurch angefallen sind.
   
• void unregistered_copyright ( void )
  Wird nicht mehr unterstuetzt. Falls der Linker eine Fehlermeldung ausgeben sollte, sollte man einfach eine leere Funktion einbauen, wie dies auch in cli.c gemacht wird.
   
• void cursor_working ( void )
  Hier sollte man den Mauszeiger als Biene oder Sanduhr darstellen, um dem Benutzer anzuzeigen, dass UDO gerade am Werkeln ist. Bei textorientierten Oberflaechen ist diese Routine leer ausgelegt.
   
• void cursor_active ( void )
  Hier sollten Funktionen eingebaut werden, um den Mauszeiger wieder als Pfeil darzustellen.
   
• BOOLEAN break_action ( void )
  Die Routine sollte TRUE zurueckgeben, falls der Benutzer den Uebersetzungsvorgang abgebrochen hat. In der GEM-Version geschieht dies durch gleichzeitiges Druecken beider Shifttasten. Textorientierte Oberflaechen sollte immer FALSE zurueckgeben.