allegro-Fortbildung                                         

   13  Sonstige Fragen
   13.4  Neuen Hilfetext oder Menü mit Flips erstellen



Auch dieser Punkt war schon kurz in Lektion 9.2 angesprochen worden!
Jeder kennt das "Füllhorn" und einige andere Menüs, die man von dort
erreichen kann.  Zum Beispiel geben Sie mal diese Befehle:
   h exprt
   h org
   h adm
   h orda
   h ct
   h table
Das sind nichts anderes als Hilfetexte mit eingebauten Verknüpfungen
zu Funktionen und zu anderen Hilfetexten.
Jeder könnte sich aber auch eigene Menüs anlegen mit allen Punkten,
die gebraucht werden. Die Hyperlinks in den Menüs, also die blauen,
unterstrichenen Sachen, nennen sich bei allegro bekanntlich "Flips".
Wie kann man sowas selber machen?
Hier enthüllen wir es erstmals Schritt für Schritt und in allen
kleinsten Einzelheiten! Eigentlich ist es ziemlich leicht und
schnell zu lernen, viel leichter als FLEX.

1. Neue RTF-Datei anlegen:
   Ein Menü mit Flips ist normalerweise eine RTF-Datei.
      Seitdem es JanaS gibt, kann es auch eine HTML-Datei sein!
      Mehr dazu: Geben Sie ein   jan janas.htm
   Hier fragen wir nur: wie mache ich eine neue RTF-Datei mit Flips?
   So geht's los:
   Alt+h (Füllhorn öffnen)
   Klicken auf "Neue Textdatei schreiben" (Mitte rechts)
   Anzeigefeld wird leer und breit.

2. In das Anzeigefeld hinein schreiben wir den Text des neuen Menüs.

   Kopieren Sie die folgenden Zeilen von hier weg in das Anzeigefeld:
   (Alle Zeilen, die zwischen den Strichen stehen!)
 


Unser eigenes Menü

   Organisation

   Umfang meiner Datenbank

   CockPit

 


3. Das ist aber erst einmal nur der Text. Nun zu den Flips!

   Der erste ruft eine Hilfedatei auf:
   a) Markieren, z.B. das Wort Organisation
      (>>Tip: Das Markieren geht am leichtesten mit der Tastatur: Marke
         vor den ersten Buchstaben, Shift und dann Cursor rechts)
   b) Mauszeiger drauf (genau auf das markierte Wort, nicht daneben!),
        rechte Maustaste, dann Funktion "Flip" wählen
   c) Unten erscheint die neue Zeile
      ?Organisation=
         und genau dahinter schreibt man   h org
      Damit wird der Hilfetext  org.rtf  geladen.
      Das ? muß genau am Anfang der Zeile stehen! Wenn nicht, dann
      Schreibmarke davorsetzen und Enter drücken.

4. Der zweite Flip ist ein eingebauter FLEX:
   Mit dem Punkt "Umfang meiner Datenbank macht man dasselbe,
   aber dafür dann unten die Zeile
   ?Umfang meiner Datenbank=x var "Es sind " t " Datensaetze"`mes
   Wieder genau am Zeilenanfang beginnend.
   Hinter dem kleinen x können mehrere FLEX-Befehle stehen, getrennt
   durch das ` (accent grave).

5. Und der dritte ruft eine FLEX-Datei auf: cockpit.flx
   Punkt "CockPit" genauso behandeln, und dafür dann unten die Zeile
   ?CockPit=X cockpit.flx
   Das große X sagt dem Programm: hier kommt der Name einer FLEX-Datei

6. Jetzt haben wir drei Flips eingerichtet. Die markierten Wörter sind
   jeweils blau geworden und unterstrichen. Die Farbe und die Unter-
   streichung sind aber nicht wichtig! Wichtig sind die Zeichen davor
   und dahinter: jeweils ein ` (der Accent grave). Diese Zeichen werden
   von der Kontextfunktion "Flip" automatisch eingesetzt, aber man
   könnte es auch mit der Hand machen.
   a99 stellt damit dann im Betrieb fest: aha, es wurde das Wort
   `Organisation`  angeklickt, und vergleicht damit die Zeilen,
   die mit ? beginnen. Es findet die Übereinstimmung, und dahinter
   den Befehl  h org. Der wird dann ausgeführt.
   Wichtig ist deswegen, daß die Zeichenfolge zwischen `...` ganz exakt
   mit der Zeichenfolge in der FlipZeile, also den Zeichen zwischen
   ? und =, übereinstimmt. Da darf aber auch kein Spatium und kein
   i-Tüpfelchen verschieden sein (so dumm können nur Programme sein,
   kein Mensch würde es so genau nehmen...)!!

7. Speichern!  Alt+s oder den Button [Speichern] betätigen.

   Dann wird nach einem Dateinamen gefragt. Geben Sie z.B. ein:
      unsers.rtf 
   (.rtf ist sehr wichtig, der Name vor dem Punkt darf anders sein!)

8. Zum Testen eingeben:   h unsers

   Das neue Menü erscheint. Klicken, um zu sehen, ob es funktioniert.
   >>SonderTip:
   Mit Alt+r kann man im Hintergrundspeicher sehen, daß die
   markierten Wörter als Variablen #uYi und die Flipzeilen als
   dazugehörige Variablen #uZi angelegt wurden (i = irgendwelche
   Zeichen)
   Es klappt nicht? Dann:

9. Dos edit unsers.rtf   (eingeben im Schreibfeld)
   (Statt "unsers" natürlich der von Ihnen beim Speichern gewählte
    Name, wenn er denn anders lautet!)
   Nun sieht man in einem blauen Editor-Fenster die Datei so, wie sie
   wirklich ist. Entscheidend sind die Zeilen am Ende. Wenn da
   z.B. steht:

   \par \f0 ?Organisation=\f1 h org
   dann liegt da der Fehler. Es muß nämlich folgendermaßen heißen
   und auf keinen Fall irgendwie anders:
   \par ?Organisation=h org
   also ohne die Zeichen \f0 und \f1
   Man nimmt \f0 und \f1 und jeweils das darauf folgende Leerzeichen
   weg und speichert die Datei wieder ab (Menue "Datei" (Alt+d)
   und Punkt "Beenden".)
   Dann nochmals Punkt 8.
   [Übrigens: \par  bedeutet "paragraph" und das heißt "Absatz". So muß
   leider in einer RTF-Datei eine neue Zeile beginnen.]

9a. >>ExpertenTip:

    Setzen Sie den ersten Befehl des Typs \f0 (kann auch \f3 oder
    sonstwas sein) in die Zeile über der ersten Flip-Zeile, so daß es
    also so aussieht (mit Spatium hinter \f0 ):
    \f0
    \par ?Organisation=h org
    Dann werden komischerweise bei künftigen Bearbeitungen solche
    Fehler in dieser Datei nicht mehr vorkommen.

Jetzt kann man jederzeit eingeben:  h unsers  , um das neue
Menü zu benutzen.

10. Ändern:

    Eingeben   h unsers.rtf
    Bearbeiten, also z.B. neue Flips nach demselben Strickmuster
    einbauen.
    Speichern:  Alt+s und mit demselben Namen speichern lassen
    Testen (Punkt 8) und evtl. korrigieren (Punkt 9)

11. Das neue Menü auf einen Flip-Button legen

    a) Nur für die Dauer der Sitzung
       Eingeben:   x flip 1&1: unserse=h unsers
       Schon kann man mit Alt+1  oder Druck auf Button 1 das neue
       Menue hervorrufen.
    b) Für die längere Dauer: Einbau in die Datei _start.flx
       Eingeben:  h _start.flx
       Man sieht, daß es da schon acht Flip-Befehle gibt.
       Einen davon muß man sich aussuchen, den man nicht braucht und
       durch den eigenen ersetzen kann. Sagen wir, die Nummer 7.
       Dann ersetzen wir die Zeile "flip 7 ..." mit der folgenden;
       flip 7&7: unserse=h unsers

12. Das neue Menü in ein anderes Menü einbauen

    Sagen wir, es soll in das View-Menü mit rein.
    Dann zuerst geben:   h view.rtf
    (Das ist der Dateiname des Tabellen-Menues)
    a) An einer passenden Stelle z.B. hinschreiben:
            Unser eigenes Menü
    b) Dann diese Wörter markieren und Rechte Maustaste / Flip
    c) Unten erscheint die Zeile
       ?Unser eigenes Menü=
       Direkt dahinter schreiben:   h unsers
    d) Speichern mit Alt+s und "table.rtf"

13. Das neue Menü in die Quick-Liste einbauen (v quick !)
    a) Die Quick-Liste als Datei laden mit   a help/quick.vw
    b) An der gewünschten Stelle (Balken setzen!) die Taste [Einfg]
       betätigen
    c) Z.B. eingeben 
          h unsers |Unser eigenes Menü
          Enter
       (Den | macht man mit  AltGr und < links neben Y)
    d) [OK] und Speicherfrage bestätigen


>>Tips für Erleichterungen:
---------------------------
A. Vorhandene Datei kopieren und abwandeln.
   Z.B.  eingeben    h ct.rtf
   Das ist ein Menü mit einigen Punkten, und zwar zentriert.
   Man ändert die einzelnen Punkte und die zugehörigen Flip-Zeilen,
   um ein neues Menü zu erstellen. Abspeichern jeweils mit  Alt+s,
   dann aber einen neuen, eigenen Namen eingeben!

B. Statt den neuen Text im Anzeigefeld zu schreiben (Punkt 1-2):
   Den Entwurf mit dem Programm Wordpad machen. Dieses findet man
   unter "Start / Programme / Zubehör"
   Vorteil: mehr Möglichkeiten der Gestaltung, z.B. Zentrieren,
   Rechtsbündig setzen, Numerierungen, Tab-Setzungen.
   Spätere Bearbeitung kann aber wieder im Schreibfeld erfolgen.
   Mit WordPad kann man auch eine der vorhandenen RTF-Dateien laden,
   bearbeiten und unter anderem Namen speichern!