home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1998 January / PCO0198.ISO / filesbbs / dos / cs340a-d.exe / DOK / REFERENZ.DOK < prev    next >
Encoding:
Text File  |  1997-07-09  |  52.7 KB  |  1,020 lines
  1.  
  2.                    "The Army Knife for ProBoard BBS Software"
  3.  
  4.    · ·· ·-──── -──·──── -──· ┌┐-──·┌─┐┌─ ──·┌─┐─────── -──·──── ──-──· -∙· ·
  5.                              │  ┌ ┌┼┬┘└─┐┌──┼┬┘│ ┐
  6.                              └─┘└─┘│└───┘└─┘│└─┴─│
  7.    · ·· ·-──── -──·──── -──· ─ -──·│─── -──·──-──┘──── -──·──── ──-──· -∙· ·
  8.  
  9.                              CURSORY, VERSION 3.40
  10.                              PROBOARD 2.1x DOS PEX
  11.  
  12.                      Copyright (C) 1995-1997 WSA Software
  13.                           Geschrieben von J. Rathmann
  14.                             ALLE RECHTE VORBEHALTEN
  15.  
  16. ╔══════════════════════════════════════════════════════════════════════════╗
  17. ║ ▒▒ Referenz ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ║ █
  18. ╚══════════════════════════════════════════════════════════════════════════╝ █
  19.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  20.  In dieser Datei finden Sie eine Referenz ALLER CSI-Schlüsselwörter,
  21.  Steuercodes, Farbmacros, Textmacros, Spezialcodes für "hotkey" und
  22.  "globalkey" und Fehlermeldungen.
  23.  
  24.  ┌─────────────────────┐
  25.  │ CSI-Schlüsselwörter │
  26.  └─────────────────────┘
  27.  
  28.           LOKALE SCHLÜSSELWÖRTER          GLOBALE SCHLÜSSELWÖRTER
  29.          ╔──────────────────────╗   ╔─────────────────────────────────╗
  30.          │ menu                 │   │ globalhotkeys   nocheck         │
  31.          │ help                 │   │ globalkey       noglobalcheck   │
  32.          │ hotkey               │   │ startmenu       log             │
  33.          │ returnkey            │   │ show            forceansi       │
  34.          │ function             │   │ numeric         forceavatar     │
  35.          │ restart              │   │ static          hide            │
  36.          │ leftgoto             │   │ elitemenu       printstart      │
  37.          │ rightgoto            │   │ elitetask       printend        │
  38.          │ upgoto               │   │ nofresh         userdoes        │
  39.          │ downgoto             │   │ noloop          timeslice       │
  40.          │ leftkey              │   ╚─────────────────────────────────╝
  41.          │ rightkey             │
  42.          │ upkey                │
  43.          │ downkey              │
  44.          │ task                 │
  45.          │ wait                 │
  46.          ╚──────────────────────╝
  47.  
  48.  ╔──────╗
  49.  │ menu │             Definiert einen neuen Menüpunkt
  50.  ╚──────╝─────────────────────────────────────────────────────────────────────
  51.  Typ ................ LOKAL
  52.  Syntax ............. menu "MENÜTEXT"
  53.                       MENÜTEXT = Text inklusive Steuercodes (eine Zusammen-
  54.                                  fassung aller Steuercodes finden Sie im
  55.                                  Abschnitt "Steuercodes")
  56.  Beispiel ........... menu "%1,1%@8,27@ Testmenüpunkt "
  57.  Beschreibung ....... Mit Hilfe dieses Schlüsselwortes werden Text,
  58.                       Position(en) und Farbe(n) EINES Menüpunktes definiert.
  59.                       Sie dient als STARTMARKIERUNG eines Menüblockes, ALLE
  60.                       nachfolgenden, LOKALEN Schlüsselwörter gehören zu diesem
  61.                       Menüblock (bis der nächste Menüpunkt mit Hilfe von
  62.                       "menu" definiert wird).
  63.  
  64.  
  65.  ╔──────╗             Definiert einen Hilfetext (Onlinehilfe) für einen
  66.  │ help │             Menüpunkt
  67.  ╚──────╝─────────────────────────────────────────────────────────────────────
  68.  Typ ................ LOKAL
  69.  Syntax ............. help "HILFETEXT"
  70.                       HILFETEXT = Text inklusive Steuercodes (eine Zusammen-
  71.                                   fassung aller Steuercodes finden Sie im
  72.                                   Abschnitt "Steuercodes")
  73.  Beispiel ........... help "%1,20%@14@Dies ist ein Hilfetext"
  74.  Beschreibung ....... Dieses Schlüsselwort definiert Text, Position(en) und
  75.                       Farbe(n) eines Hilfetextes. Dieser Hilfetext gehört
  76.                       jeweils zum ZULETZT definierten Menüpunkt.
  77.  
  78.  
  79.  ╔────────╗
  80.  │ hotkey │           Definiert einen "Hotkey" für einen Menüpunkt
  81.  ╚────────╝───────────────────────────────────────────────────────────────────
  82.  Typ ................ LOKAL
  83.  Syntax ............. hotkey HOTKEY
  84.                       HOTKEY = ASCII-Zeichen
  85.                                ODER
  86.                                ASCII-Code mit vorausgehendem "#"
  87.  Beispiele .......... hotkey a
  88.                       hotkey #27
  89.  Beschreibung ....... Dieses Schlüsselwort definiert einen LOKALEN Hotkey für
  90.                       den ZULETZT definierten Menüpunkt. Dieser Menüpunkt kann
  91.                       dann alternativ zur Auswahl über die Cursortasten und
  92.                       "RETURN" auch über das angegebene Zeichen direkt
  93.                       ausgewählt werden. Es ist egal, ob der HOTKEY in Klein-
  94.                       oder Großschreibung angegeben wird.
  95.  
  96.  
  97.  ╔───────────╗        Definiert ein Zeichen, das bei Wahl des zugehörigen
  98.  │ returnkey │        Menüpunktes an ProBoard gesendet wird
  99.  ╚───────────╝────────────────────────────────────────────────────────────────
  100.  Typ ................ LOKAL
  101.  Syntax ............. returnkey RETURNKEY
  102.                       RETURNKEY = ASCII-Zeichen
  103.                                   ODER
  104.                                   ASCII-Code mit vorausgehendem "#"
  105.  Beispiele .......... returnkey a
  106.                       returnkey #65
  107.  Beschreibung ....... Mit Hilfe dieses Schlüsselwortes wird ein Zeichen
  108.                       definiert, das bei Wahl des zugehörigen Menüpunktes an
  109.                       ProBoard gesendet wird. Dieses Zeichen muß im ProBoard-
  110.                       MENÜEDITOR als HOTKEY definiert sein. Das angegebene
  111.                       Zeichen wird NACH Ausführung einer evtl. mittels
  112.                       "function" definierten Funktion an ProBoard gesendet. Es
  113.                       ist egal, ob der RETURNKEY in Klein- oder Großschreibung angegeben
  114.                       wird.
  115.  
  116.  
  117.  ╔───────────╗        Definiert eine Funktion, die bei Wahl des zugehörigen
  118.  │ function  │        Menüpunktes ausgeführt wird
  119.  ╚───────────╝────────────────────────────────────────────────────────────────
  120.  Typ ................ LOKAL
  121.  Syntax ............. function FUNKTIONSNUMMER
  122.                       ODER
  123.                       function FUNKTIONSNUMMER, "PARAMETER"
  124.                       FUNKTIONSNUMMER = ProBoard-Funktion (eine Zusammen-
  125.                                         fassung aller ProBoard-Funktionen
  126.                                         finden Sie in der ProBoard-Dokumenta-
  127.                                         tion)
  128.                       PARAMETER = Parameter (falls erforderlich)
  129.  Beispiele .......... function 8
  130.                       function 60, "TEXTSRCH"
  131.  Beschreibung ....... Mit Hilfe dieses Schlüsselwortes wird eine ProBoard-
  132.                       Funktion definiert, die bei Wahl des zugehörigen
  133.                       Menüpunktes ausgeführt wird. Nach Beenden der Ausführung
  134.                       wird das Menü verlassen (kann mit "restart" umgangen
  135.                       werden). Die angegebene Funktion wird VOR Rückgabe eines
  136.                       evtl. mittels "returnkey" definierten Zeichens
  137.                       ausgeführt.
  138.  
  139.  
  140.  ╔─────────╗          Veranlaßt, daß CURSORY nach Ausführung einer Funktion
  141.  │ restart │          erneut gestartet wird
  142.  ╚─────────╝──────────────────────────────────────────────────────────────────
  143.  Typ ................ LOKAL
  144.  Syntax ............. restart
  145.  Beschreibung ....... Bewirkt, daß nach Auswahl eines BESTIMMTEN Menüpunktes
  146.                       und Ausführung einer für diesen Menüpunkt definierten
  147.                       Funktion das Menü NICHT verlassen wird. Stattdessen wird
  148.                       die CSI-Datei erneut aufgerufen (die Datei wird NICHT
  149.                       erneut physikalisch gelesen).
  150.  
  151.  
  152.  ╔──────────╗         Definiert den Menüpunkt, der angesprungen wird, wenn der
  153.  │ leftgoto │         User auf dem zugehörigen Menüpunkt CURSOR-LINKS drückt
  154.  ╚──────────╝─────────────────────────────────────────────────────────────────
  155.  Typ ................ LOKAL
  156.  Syntax ............. leftgoto MENÜPUNKT
  157.                       MENÜPUNKT = Nummer eines Menüpunktes
  158.                       Anmerkung: Die Menüpunkte in einer CSI-Datei werden
  159.                                  der Reihe nach (linear) von oben nach unten
  160.                                  durchnummeriert
  161.  Voreinstellung ..... Zugehöriger Menüpunkt - 1
  162.  Beispiel ........... leftgoto 4
  163.  Beschreibung ....... Drückt der User auf dem zugehörigen Menüpunkt die Taste
  164.                       CURSOR-LINKS, so wird der angegebene Menüpunkt angewählt
  165.                       (NICHT ausgewählt!). Alle ungültigen Angaben werden
  166.                       ignoriert.
  167.  
  168.  
  169.  ╔───────────╗        Definiert den Menüpunkt, der angesprungen wird, wenn der
  170.  │ rightgoto │        User auf dem zugehörigen Menüpunkt CURSOR-RECHTS drückt
  171.  ╚───────────╝────────────────────────────────────────────────────────────────
  172.  Typ ................ LOKAL
  173.  Syntax ............. rightgoto MENÜPUNKT
  174.                       MENÜPUNKT = Nummer eines Menüpunktes
  175.                       Anmerkung: Die Menüpunkte in einer CSI-Datei werden
  176.                                  der Reihe nach (linear) von oben nach unten
  177.                                  durchnummeriert
  178.  Voreinstellung ..... Zugehöriger Menüpunkt + 1
  179.  Beispiel ........... rightgoto 4
  180.  Beschreibung ....... Drückt der User auf dem zugehörigen Menüpunkt die Taste
  181.                       CURSOR-RECHTS, so wird der angegebene Menüpunkt
  182.                       angewählt (NICHT ausgewählt!). Alle ungültigen Angaben
  183.                       werden ignoriert.
  184.  
  185.  
  186.  ╔────────╗           Definiert den Menüpunkt, der angesprungen wird, wenn der
  187.  │ upgoto │           User auf dem zugehörigen Menüpunkt CURSOR-HOCH drückt
  188.  ╚────────╝───────────────────────────────────────────────────────────────────
  189.  Typ ................ LOKAL
  190.  Syntax ............. upgoto MENÜPUNKT
  191.                       MENÜPUNKT = Nummer eines Menüpunktes
  192.                       Anmerkung: Die Menüpunkte in einer CSI-Datei werden
  193.                                  der Reihe nach (linear) von oben nach unten
  194.                                  durchnummeriert
  195.  Voreinstellung ..... Zugehöriger Menüpunkt - 1
  196.  Beispiel ........... upgoto 4
  197.  Beschreibung ....... Drückt der User auf dem zugehörigen Menüpunkt die Taste
  198.                       CURSOR-HOCH, so wird der angegebene Menüpunkt angewählt
  199.                       (NICHT ausgewählt!). Alle ungültigen Angaben werden
  200.                       ignoriert.
  201.  
  202.  
  203.  ╔──────────╗         Definiert den Menüpunkt, der angesprungen wird, wenn der
  204.  │ downgoto │         User auf dem zugehörigen Menüpunkt CURSOR-RUNTER drückt
  205.  ╚──────────╝─────────────────────────────────────────────────────────────────
  206.  Typ ................ LOKAL
  207.  Syntax ............. downgoto MENÜPUNKT
  208.                       MENÜPUNKT = Nummer eines Menüpunktes
  209.                       Anmerkung: Die Menüpunkte in einer CSI-Datei werden
  210.                                  der Reihe nach (linear) von oben nach unten
  211.                                  durchnummeriert
  212.  Voreinstellung ..... Zugehöriger Menüpunkt + 1
  213.  Beispiel ........... downgoto 4
  214.  Beschreibung ....... Drückt der User auf dem zugehörigen Menüpunkt die Taste
  215.                       CURSOR-RUNTER, so wird der angegebene Menüpunkt
  216.                       angewählt (NICHT ausgewählt!). Alle ungültigen Angaben
  217.                       werden ignoriert.
  218.  
  219.  
  220.  ╔─────────╗          Definiert ein Zeichen, das nach Drücken von CURSOR-LINKS
  221.  │ leftkey │          auf dem zugehörigen Menüpunkt gesendet wird
  222.  ╚─────────╝──────────────────────────────────────────────────────────────────
  223.  Typ ................ LOKAL
  224.  Syntax ............. leftkey LEFTKEY
  225.                       LEFTKEY = ASCII-Zeichen
  226.                                 ODER
  227.                                 ASCII-Code mit vorausgehendem "#"
  228.  Beispiele .......... leftkey a
  229.                       leftkey #65
  230.  Beschreibung ....... Drückt der User auf dem zugehörigen Menüpunkt die Taste
  231.                       CURSOR-LINKS, so wird der angegebene LEFTKEY an ProBoard
  232.                       gesendet. Ist für einen Menüpunkt sowohl "leftkey" als
  233.                       auch "leftgoto" definiert, so hat "leftkey" eine höhere
  234.                       Priorität.
  235.  
  236.  
  237.  ╔──────────╗         Definiert ein Zeichen, das nach Drücken von CURSOR-
  238.  │ rightkey │         RECHTS auf dem zugehörigen Menüpunkt gesendet wird
  239.  ╚──────────╝─────────────────────────────────────────────────────────────────
  240.  Typ ................ LOKAL
  241.  Syntax ............. rightkey RIGHTKEY
  242.                       RIGHTKEY = ASCII-Zeichen
  243.                                  ODER
  244.                                  ASCII-Code mit vorausgehendem "#"
  245.  Beispiele .......... rightkey a
  246.                       rightkey #65
  247.  Beschreibung ....... Drückt der User auf dem zugehörigen Menüpunkt die Taste
  248.                       CURSOR-RECHTS, so wird der angegebene RIGHTKEY an
  249.                       ProBoard gesendet. Ist für einen Menüpunkt sowohl
  250.                       "rightkey" als auch "rightgoto" definiert, so hat
  251.                       "rightkey" eine höhere Priorität.
  252.  
  253.  
  254.  ╔───────╗            Definiert ein Zeichen, das nach Drücken von CURSOR-HOCH
  255.  │ upkey │            auf dem zugehörigen Menüpunkt gesendet wird
  256.  ╚───────╝────────────────────────────────────────────────────────────────────
  257.  Typ ................ LOKAL
  258.  Syntax ............. upkey UPKEY
  259.                       UPKEY = ASCII-Zeichen
  260.                               ODER
  261.                               ASCII-Code mit vorausgehendem "#"
  262.  Beispiele .......... upkey a
  263.                       upkey #65
  264.  Beschreibung ....... Drückt der User auf dem zugehörigen Menüpunkt die Taste
  265.                       CURSOR-HOCH, so wird der angegebene UPKEY an ProBoard
  266.                       gesendet. Ist für einen Menüpunkt sowohl "upkey" als
  267.                       auch "upgoto" definiert, so hat "upkey" eine höhere
  268.                       Priorität.
  269.  
  270.  
  271.  ╔─────────╗          Definiert ein Zeichen, das nach Drücken von CURSOR-
  272.  │ downkey │          RUNTER auf dem zugehörigen Menüpunkt gesendet wird
  273.  ╚─────────╝──────────────────────────────────────────────────────────────────
  274.  Typ ................ LOKAL
  275.  Syntax ............. downkey DOWNKEY
  276.                       DOWNKEY = ASCII-Zeichen
  277.                                 ODER
  278.                                 ASCII-Code mit vorausgehendem "#"
  279.  Beispiele .......... downkey a
  280.                       downkey #65
  281.  Beschreibung ....... Drückt der User auf dem zugehörigen Menüpunkt die Taste
  282.                       CURSOR-RUNTER, so wird der angegebene DOWNKEY an
  283.                       ProBoard gesendet. Ist für einen Menüpunkt sowohl
  284.                       "downkey" als auch "downgoto" definiert, so hat
  285.                       "downkey" eine höhere Priorität.
  286.  
  287.  
  288.  ╔──────╗
  289.  │ task │             Definiert EINE Animations-Sequenz
  290.  ╚──────╝─────────────────────────────────────────────────────────────────────
  291.  Typ ................ LOKAL (TASK)
  292.  Syntax ............. task "ANIMATIONSSEQUENZ"
  293.                       ANIMATIONSSEQUENZ = Text inklusive Steuercodes (eine
  294.                                           Zusammenfassung aller Steuercodes
  295.                                           finden Sie im Abschnitt
  296.                                           "Steuercodes")
  297.  Beispiel ........... task "%1,24%@7@Dies ist ein Teil einer Animation"
  298.  Beschreibung ....... Mit Hilfe dieses Schlüsselwortes können Sie eine
  299.                       Animationssequenz (einen "Zustand" einer Animation)
  300.                       definieren.
  301.                       Sind mehrere "Tasks" definiert, so werden diese während
  302.                       der Laufzeit der Reihe nach von oben nach unten
  303.                       "durchlaufen". Ist der letzte "Task" (also das Ende der
  304.                       Animation) erreicht, so wird wieder von vorne begonnen
  305.                       (kann mittels "noloop" umgangen werden). Ein "task"
  306.                       ist zwar LOKAL, steht jedoch in keinem Zusammenhang
  307.                       mit einem Menüblock. "Lokal" bezieht sich hier lediglich
  308.                       auf das Schlüsselwort "wait".
  309.  
  310.  
  311.  ╔──────╗             Definiert, wie lange nach Ausgabe des zugehörigen "task"
  312.  │ wait │             bis zur nächsten Animationssequenz gewartet wird
  313.  ╚──────╝─────────────────────────────────────────────────────────────────────
  314.  Typ ................ LOKAL (TASK)
  315.  Syntax ............. wait VERZÖGERUNG
  316.                       VERZÖGERUNG = Wert für Verzögerung (ein Wert von 18
  317.                                     verzögert um ca. 1 Sekunde)
  318.  Voreinstellung ..... 0
  319.  Beispiel ........... wait 10
  320.  Beschreibung ....... Dieses Schlüsselwort definiert die "Wartezeit" nach
  321.                       Ausgabe des zugehörigen "Tasks". Erst nach Beenden
  322.                       dieser Wartezeit wird der nächste "Task" ausgegeben.
  323.                       Dieses Schlüsselwort ist OPTIONAL, es muß NICHT
  324.                       unbedingt nach jedem "task" angegeben werden. In diesem
  325.                       Fall wäre der Wert 0 (keine Verzögerung) voreingestellt.
  326.                       Die einzelnen Werte nach "wait" können durchaus
  327.                       unterschiedlich sein, wodurch eine Änderung der
  328.                       Animationsgeschwindigkeit WÄHREND der Ausgabe möglich
  329.                       ist!
  330.  
  331.  
  332.  ╔───────────────╗
  333.  │ globalhotkeys │    Definiert MEHRERE globale Hotkeys
  334.  ╚───────────────╝────────────────────────────────────────────────────────────
  335.  Typ ................ GLOBAL
  336.  Syntax ............. globalhotkeys "HOTKEYS"
  337.                       HOTKEYS = Aufzählung von Zeichen
  338.  Beispiel ........... globalhotkeys "!#%?$*-"
  339.  Beschreibung ....... Definiert globale Hotkeys oder generell Zeichen, die
  340.                       ebenfalls an ProBoard übergeben werden. Wird während der
  341.                       Menüauswahl eine Taste gedrückt, die weder zur Steuerung
  342.                       dient noch als lokaler Hotkey definiert ist, so wird
  343.                       dies normalerweise ignoriert. Mit Hilfe dieses
  344.                       Schlüsselwortes können Sie ZUSÄTZLICHE Zeichen
  345.                       definieren, die ebenfalls an ProBoard gesendet werden.
  346.                       Dies können zum Beispiel Hotkeys sein, die im GLOBALEN
  347.                       Menü im ProBoard-Menüeditor definiert worden sind.
  348.                       "globalhotkeys" kann durchaus MEHRFACH in einer CSI-
  349.                       Datei vorkommen.
  350.  
  351.  
  352.  ╔───────────╗        Definiert EINEN globalen Hotkey, zusätzlich kann ein
  353.  │ globalkey │        getrennter "Returnkey" angegeben werden
  354.  ╚───────────╝────────────────────────────────────────────────────────────────
  355.  Typ ................ GLOBAL
  356.  Syntax ............. globalkey HOTKEY
  357.                       ODER
  358.                       globalkey HOTKEY, RETURNKEY
  359.                       HOTKEY = ASCII-Zeichen
  360.                                ODER
  361.                                ASCII-Code mit vorausgehendem "#"
  362.                       RETURNKEY = ASCII-Zeichen
  363.                                   ODER
  364.                                   ASCII-Code mit vorausgehendem "#"
  365.  Beispiele .......... globalkey ?
  366.                       globalkey #63
  367.                       globalkey #27, !
  368.  Beschreibung ....... Mit Hilfe dieses Schlüsselwortes kann EIN globaler 
  369.                       Hotkey definiert werden (siehe auch CSI-Schlüsselwort
  370.                       "globalhotkeys"), jedoch kann zusätzlich optional ein
  371.                       RETURNKEY angegeben werden. Ist dies der Fall, so wird,
  372.                       drückt der User den definierten HOTKEY, der RETURNKEY
  373.                       gesendet. Dadurch ist eine GLOBALE Trennung von Hotkeys
  374.                       und Returnkeys möglich (äquivalent zur lokalen Trennung
  375.                       mit Hilfe der CSI-Schlüsselwörter "hotkey" und
  376.                       "returnkey"). Ist kein RETURNKEY definiert, so wird der
  377.                       HOTKEY (wie bei "globalhotkeys") gesendet. "globalkey a"
  378.                       hat demnach dieselbe Wirkung wie "globalkey a, a".
  379.                       Dieses Schlüsselwort kann durchaus MEHRFACH in einer
  380.                       CSI-Datei vorkommen. Es ist egal, ob der HOTKEY bzw. der
  381.                       RETURNKEY in Klein- oder Großschreibung angegeben wird.
  382.  
  383.  
  384.  ╔───────────╗
  385.  │ startmenu │        Definiert den Menüpunkt, der beim Start ANGEWÄHLT ist
  386.  ╚───────────╝────────────────────────────────────────────────────────────────
  387.  Typ ................ GLOBAL
  388.  Syntax ............. startmenu MENÜPUNKT
  389.                       MENÜPUNKT = Nummer eines Menüpunktes
  390.                       Anmerkung: Die Menüpunkte in einer CSI-Datei werden
  391.                                  der Reihe nach (linear) von oben nach unten
  392.                                  durchnummeriert
  393.  Voreinstellung ..... 1
  394.  Beispiel ........... startmenu 4
  395.  Beschreibung ....... Der Wert nach diesem CSI-Schlüsselwort gibt den
  396.                       Menüpunkt an, der beim Start angewählt (nicht
  397.                       AUSGEWÄHLT!) ist. Fehlt dieses Schlüsselwort, so ist
  398.                       dies der erste Menüpunkt. Alle ungültigen Angaben werden
  399.                       ignoriert. Ist zusätzlich das Schlüsselwort "static"
  400.                       definiert, so hat "startmenu" nur beim ERSTEN Aufruf des
  401.                       Menüs eine Wirkung.
  402.  
  403.  
  404.  ╔──────╗
  405.  │ show │             Gibt eine ANSI- oder AVATAR-Datei aus
  406.  ╚──────╝─────────────────────────────────────────────────────────────────────
  407.  Typ ................ GLOBAL
  408.  Syntax ............. show "DATEINAME"
  409.                       DATEINAME = Name einer ANSI/AVATAR-Datei OHNE Pfad und
  410.                                   Dateiendung
  411.  Beispiel ........... show "MAIN"
  412.  Beschreibung ....... Zeigt eine ANSI/AVATAR-Datei als Hintergrundbild eines
  413.                       Menüs. Die Datei *MUSS* sich im ProBoard-TXTFILES-
  414.                       Verzeichnis befinden. Wird die angegebene Datei nicht
  415.                       gefunden, so wird der Befehl ignoriert.
  416.  
  417.  
  418.  ╔─────────╗
  419.  │ numeric │          Ermöglicht die alternative Steuerung über 2, 4, 6 und 8
  420.  ╚─────────╝──────────────────────────────────────────────────────────────────
  421.  Typ ................ GLOBAL
  422.  Syntax ............. numeric
  423.  Beschreibung ....... Ermöglicht die alternative Steuerung über die Tasten
  424.                       2, 4, 6 und 8 (als Ersatz für die Cursortasten). Sind
  425.                       identische Hotkeys definiert, so haben diese eine HÖHERE
  426.                       Priorität!
  427.  
  428.  
  429.  ╔────────╗           Bewirkt, daß der zuletzt angewählte Menüpunkt gesichert
  430.  │ static │           und bei erneutem Aufruf des Menüs wieder angewählt wird
  431.  ╚────────╝───────────────────────────────────────────────────────────────────
  432.  Typ ................ GLOBAL
  433.  Syntax ............. static
  434.  Beschreibung ....... Ist dieses Schlüsselwort in einer CSI-Datei definiert,
  435.                       so wird der zuletzt angewählte Menüpunkt bei Verlassen
  436.                       eines Menüs gesichert. Wird dasselbe Menü nochmals
  437.                       aufgerufen, so ist nicht der erste bzw. der mit
  438.                       "startmenu" definierte, sondern der gesicherte Menüpunkt
  439.                       angewählt. Dieses Schlüsselwort hat demnach eine höhere
  440.                       Priorität als "startmenu".
  441.  
  442.  
  443.  ╔───────────╗        Konvertiert alle Zeichen in den Menütexten und
  444.  │ elitemenu │        Hilfetexten in "Elite-Schrift"
  445.  ╚───────────╝────────────────────────────────────────────────────────────────
  446.  Typ ................ GLOBAL
  447.  Syntax ............. elitemenu
  448.  Beschreibung ....... Ist dieses Schlüsselwort definiert, so werden ALLE
  449.                       Menüpunkte und Hilfetexte in sog. "Elite"-Schrift
  450.                       konvertiert. Es werden folgende Änderungen vorgenommen:
  451.                       1. Alle Buchstaben werden in Großschrift umgewandelt
  452.                       2. 'A' (ASCII-Code 065) wird zu 'Æ' (ASCII-Code 146)
  453.                       3. 'E' (ASCII-Code 069) wird zu 'ε' (ASCII-Code 238)
  454.                       4. 'F' (ASCII-Code 070) wird zu 'ƒ' (ASCII-Code 159)
  455.                       5. 'I' (ASCII-Code 073) wird zu 'i' (ASCII-Code 105)
  456.                       6. 'N' (ASCII-Code 078) wird zu '∩' (ASCII-Code 239)
  457.  
  458.  
  459.  ╔───────────╗        Konvertiert alle Zeichen in den Animationssequenzen in
  460.  │ elitetask │        "Elite-Schrift"
  461.  ╚───────────╝────────────────────────────────────────────────────────────────
  462.  Typ ................ GLOBAL
  463.  Syntax ............. elitetask
  464.  Beschreibung ....... Konvertiert die Texte ALLER Animationssequenzen (mittels
  465.                       "task" definiert) in "Elite"-Schrift. Nähere
  466.                       Informationen finden Sie unter "elitemenu".
  467.  
  468.  
  469.  ╔─────────╗          Bewirkt, daß die Menüpunkte beim Start NICHT ausgegeben
  470.  │ nofresh │          werden (nur der Startmenüpunkt ist sichtbar)
  471.  ╚─────────╝──────────────────────────────────────────────────────────────────
  472.  Typ ................ GLOBAL
  473.  Syntax ............. nofresh
  474.  Beschreibung ....... Dieses Schlüsselwort bewirkt ein "Nichtauffrischen" der
  475.                       Menüpunkte beim Start. Normalerweise werden beim Aufruf
  476.                       einer CSI-Datei ALLE darin definierten Menüpunkte
  477.                       zunächst einmalig ausgegeben, damit der User überhaupt
  478.                       sieht, zwischen welchen Möglichkeiten er auswählen kann.
  479.                       Wird das Schlüsselwort "nofresh" verwendet, so wird beim
  480.                       Start NUR der Startmenüpunkt (beim Start automatisch
  481.                       angewählt) ausgegeben. Dadurch ist es möglich, alle
  482.                       Menüpunkte schon ins Hintergrundbild selbst (siehe CSI-
  483.                       Schlüsselwort "show") "einzutragen", ohne daß CURSORY
  484.                       diese beim Start nochmals überschreibt. Dies stört zwar
  485.                       im Prinzip nicht, ist aber bei sehr vielen Menüpunkten
  486.                       und einer schlechten Leitung durchaus erkennbar. Der
  487.                       Vorteil beim Einbau aller Menüpunkte (in der
  488.                       "nichtangewählten" Farbe!) in das Hintergrundbild ist,
  489.                       daß diese SOFORT für den User sichbar sind, während ohne
  490.                       "nofresh" ERST das Hintergrundbild und DANN die
  491.                       Menüpunkte erscheinen. Sie sollten "nofresh" NUR
  492.                       verwenden, wenn Sie der zuletzt genannte Aspekt wirklich
  493.                       stört, da dieses Schlüsselwort auch zwei Nachteile hat:
  494.  
  495.                       1. Sie müssen selbst darauf achten, daß die in der CSI-
  496.                          Datei definierten Menütexte EXAKT mit denen im
  497.                          Hintergrundbild übereinstimmen
  498.                       2. Das Schlüsselwort "elitemenu" wirkt erst dann, wenn
  499.                          der User die Menüpunkte mindestens EINMAL angewählt
  500.                          hat. Möchten Sie dieses Schlüsselwort verwenden, so
  501.                          müssen Sie im Hintergrundbild selbst schon alle Texte
  502.                          in "Elite"-Schrift eintragen (siehe CSI-Schlüsselwort
  503.                          "elitemenu")
  504.  
  505.  
  506.  ╔────────╗           Bewirkt, daß eine definierte Animation NICHT ständig
  507.  │ noloop │           wiederholt, sondern nur EINMALIG durchlaufen wird
  508.  ╚────────╝───────────────────────────────────────────────────────────────────
  509.  Typ ................ GLOBAL
  510.  Syntax ............. noloop
  511.  Beschreibung ....... Ist dieses Schlüsselwort definiert und die letzte
  512.                       Animationssequenz ist erreichen, so wird die Animation
  513.                       NICHT wiederholt. Dieses Schlüsselwort hat nur eine
  514.                       Wirkung, wenn auch wirklich eine Animation definiert
  515.                       ist, ansonsten wird es ignoriert.
  516.  
  517.  
  518.  ╔─────────╗
  519.  │ nocheck │          Deaktiviert die Zugangsprüfung für alle Menüpunkte
  520.  ╚─────────╝──────────────────────────────────────────────────────────────────
  521.  Typ ................ GLOBAL
  522.  Syntax ............. nocheck
  523.  Beschreibung ....... Nach Auswahl eines Menüpunktes wird NICHT automatisch
  524.                       auf Zugangsberechtigung geprüft, ein eventuell
  525.                       vorhandener Returnkey wird somit in jedem Fall an
  526.                       ProBoard übergeben (und hier möglicherweise als nicht
  527.                       zulässig erkannt). Dieser Befehl sollte dann verwendet
  528.                       werden, wenn CURSORY aus einer Sprachdatei heraus
  529.                       aufgerufen wird, ansonsten wird die Fehlermeldung
  530.                       "Could not open PBM-file" ausgegeben (eine PBM-Datei
  531.                       enthält Informationen über die Einschränkungen bei der
  532.                       Auswahl eines Menüpunktes).
  533.  
  534.  
  535.  ╔───────────────╗    Deaktiviert die Zugangsprüfung für die Menüpunkte im
  536.  │ noglobalcheck │    GLOBALEN Menü
  537.  ╚───────────────╝────────────────────────────────────────────────────────────
  538.  Typ ................ GLOBAL
  539.  Syntax ............. noglobalcheck
  540.  Beschreibung ....... Ähnlich "nocheck", jedoch wird NUR die GLOBALE Prüfung
  541.                       deaktiviert. Benutzen Sie dieses Schlüsselwort, wenn Sie
  542.                       zwar Zugangsprüfung wünschen, jedoch kein globales Menü
  543.                       im ProBoard-Menüeditor verwenden (Datei GLOBAL.PBM).
  544.  
  545.  
  546.  ╔─────╗              Aktiviert die "LOG"-Funktion / einige Laufzeitinforma-
  547.  │ log │              tionen werden in die Datei PROBOARD.LOG geschrieben
  548.  ╚─────╝──────────────────────────────────────────────────────────────────────
  549.  Typ ................ GLOBAL
  550.  Syntax ............. log
  551.  Beschreibung ....... Ist dieses Schlüsselwort definiert, so werden einige
  552.                       nützliche Laufzeitinformationen (gewählte Menüpunkte,
  553.                       ausgeführte Funktionen etc.) in die Datei PROBOARD.LOG
  554.                       geschrieben.
  555.  
  556.  
  557.  ╔───────────╗
  558.  │ forceansi │        Zwingt CURSORY, die ANSI-Emulation zu benutzen
  559.  ╚───────────╝────────────────────────────────────────────────────────────────
  560.  Typ ................ GLOBAL
  561.  Syntax ............. forceansi
  562.  Beschreibung ....... CURSORY startet, ist dieses Schlüsselwort definiert, auf
  563.                       jeden Fall im ANSI-Modus. Dies ist z. B. beim LOGIN
  564.                       sinnvoll.
  565.  
  566.  
  567.  ╔─────────────╗
  568.  │ forceavatar │  Zwingt CURSORY, die AVATAR-Emulation zu benutzen
  569.  ╚─────────────╝──────────────────────────────────────────────────────────────
  570.  Typ ................ GLOBAL
  571.  Syntax ............. forceavatar
  572.  Beschreibung ....... CURSORY startet, ist dieses Schlüsselwort definiert, auf
  573.                       jeden Fall im AVATAR-Modus. Dies ist z. B. beim LOGIN
  574.                       sinnvoll.
  575.  
  576.  
  577.  ╔──────╗
  578.  │ hide │             Unterdrückt das Cursorblinken GLOBAL
  579.  ╚──────╝─────────────────────────────────────────────────────────────────────
  580.  Typ ................ GLOBAL
  581.  Syntax ............. hide X, Y
  582.                       ODER
  583.                       hide X, Y, NOHIDE
  584.                       X = X-Position
  585.                       Y = Y-Position
  586.                       NOHIDE = 0 oder 1
  587.                                Wert 1 bedeutet, daß der Cursor nicht
  588.                                "versteckt" wird, nachdem er auf die angegebene
  589.                                Position versetzt wurde (0 ist voreingestellt)
  590.  Beispiel ........... hide 79, 24
  591.                       hide 79, 24, 1
  592.  Beschreibung ....... Das Cursorblinken wird GLOBAL unterdrückt. Dieses
  593.                       Schlüsselwort ist ein Ersatz für das Steuerzeichen "*".
  594.                       Wird dieses Schlüsselwort verwendet, so wird nach JEDER
  595.                       Veränderung auf dem Bildschirm der Cursor auf die
  596.                       angegebene Position gesetzt und dort -scheinbar-
  597.                       UNSICHTBAR gemacht (auch für den User!). Der Unterschied
  598.                       zum Steuerzeichen "*" besteht lediglich darin, daß der
  599.                       Cursor immer wieder an eine fest definierte Bildschirm-
  600.                       position gesetzt wird, während das "Unterdrücken"
  601.                       mittels "*" immer an der AKTUELLEN Position erfolgt.
  602.                       HINWEIS: "hide 80, 24" führt zum "Hochscrollen" des
  603.                       Bildschirms.
  604.  
  605.  
  606.  ╔────────────╗
  607.  │ printstart │       Gibt einen Text VOR Aufruf der Cursorsteuerung aus
  608.  ╚────────────╝───────────────────────────────────────────────────────────────
  609.  Typ ................ GLOBAL
  610.  Syntax ............. printstart "TEXT"
  611.                       TEXT = Text inklusive Steuercodes (eine Zusammenfassung
  612.                              aller Steuercodes finden Sie im Abschnitt
  613.                              "Steuercodes")
  614.  Beispiel ........... printstart "%1,1%@15@Willkommen in diesem Menü!"
  615.  Beschreibung ....... Der nach diesem Schlüsselwort angegebene Text wird noch
  616.                       VOR Aufruf der Cursorsteuerung (bzw. der Animation,
  617.                       falls keine Menüpunkte definiert sind) ausgegeben. Dies
  618.                       erfolgt NACH Ausgabe eines evtl. definierten Hinter-
  619.                       grundbildes (siehe CSI-Schlüsselwort "show"). Dieses
  620.                       Schlüsselwort kann z. B. zur Ausgabe von statischen
  621.                       Textmacros (ändern sich nicht) verwendet werden (z. B.
  622.                       Name oder Wohnort des Users).
  623.  
  624.  
  625.  ╔──────────╗         Gibt einen Text NACH Beenden der Cursorsteuerung und
  626.  │ printend │         noch VOR Verlassen des Programms aus
  627.  ╚──────────╝─────────────────────────────────────────────────────────────────
  628.  Typ ................ GLOBAL
  629.  Syntax ............. printend "TEXT"
  630.                       TEXT = Text inklusive Steuercodes (eine Zusammenfassung
  631.                       aller Steuercodes finden Sie im Abschnitt "Steuercodes")
  632.  Beispiel ........... printend "ⁿ²"
  633.                       ⁿ (Steuerzeichen) = Bildschirm löschen
  634.                       ² (Steuerzeichen) = User ausloggen
  635.  Beschreibung ....... Ähnlich "printstart", jedoch wird dieser Text NACH
  636.                       Beenden der Menüauswahl und VOR Verlassen des Programms
  637.                       ausgegeben. Dies ist zum Beispiel dann sinnvoll, wenn in
  638.                       einer CSI-Datei eine Animation definiert ist, der
  639.                       "hide"-Befehl aber NICHT verwendet wird. Die Cursor-
  640.                       position ist in diesem Fall nicht in jedem Zeitpunkt
  641.                       definiert, so daß ein Verlassen des Menüs evtl. Ausgaben
  642.                       von ProBoard an verkehrter Stelle hervorrufen könnte.
  643.                       "Fehler" dieser Art treten zum Beispiel bei der
  644.                       Verwendung der internen Nachrichten-Leseroutine auf.
  645.                       Nachdem der User den Menüpunkt "Nachrichten lesen"
  646.                       ausgewählt hat, wird die Abfrage, welche Nachrichten
  647.                       gelesen werden sollen, MITTEN in das Hintergrundbild
  648.                       geschrieben. Dies kann mit Hilfe der Schlüsselwörter
  649.                       "printend" ODER "hide" (der Cursor wird zusätzlich noch
  650.                       unterdrückt) umgangen werden. Eine weitere Nutzungs-
  651.                       möglichkeit für "printend" besteht z. B. darin, den User
  652.                       nach Verlassen eines Menüs direkt "auszuloggen" (z. B.
  653.                       beim Login).
  654.  
  655.  
  656.  ╔──────────╗         Erzeugt eine USERDOES-Datei im ProBoard-Systemverzeich-
  657.  │ userdoes │         nis
  658.  ╚──────────╝─────────────────────────────────────────────────────────────────
  659.  Typ ................ GLOBAL
  660.  Syntax ............. userdoes "TEXT"
  661.  Beispiel ........... userdoes "Testet CURSORY :-)"
  662.  Beschreibung ....... Mit Hilfe dieses Schlüsselwortes kann vor dem
  663.                       Programmstart eine Datei im Format "USERDOES.*" im
  664.                       ProBoard-Systemverzeichnis erzeugt werden, wobei "*" für
  665.                       die jeweilige Nodenummer steht. Diese Datei kann
  666.                       Informationen über die aktuelle Aktivität eines Users
  667.                       enthalten. Sie kann mit Hilfe spezieller Programme
  668.                       (z. B. USERDOES von DQP) ausgelesen werden. Jeder CSI-
  669.                       Datei (also auch beim Aufruf aus einer Sprachdatei!)
  670.                       kann ein USERDOES-Text zugeordnet werden. Wird z. B.
  671.                       userdoes "Testet CURSORY" in einer CSI-Datei definiert
  672.                       und dieses Menü auf Node 1 aufgerufen, so können alle
  673.                       anderen User, benutzen Sie gerade z. B. das oben
  674.                       genannte DQP-USERDOES, sehen, daß User Nr. 1 gerade
  675.                       CURSORY testet :-).
  676.  
  677.  
  678.  ╔───────────╗        Definiert die Anzahl der pro Zeiteinheit freigegebenen
  679.  │ timeslice │        "Timeslices" unter einem Multitasker
  680.  ╚───────────╝────────────────────────────────────────────────────────────────
  681.  Typ ................ GLOBAL
  682.  Syntax ............. timeslice WERT
  683.                       WERT = ein dezimaler Wert
  684.  Voreinstellung ..... 1
  685.  Beispiel ........... timeslice 5
  686.  Beschreibung ....... Der Wert nach diesem Schlüsselwort legt fest, wieviele
  687.                       "Timeslices" pro Zeiteinheit freigegeben werden, wenn
  688.                       CURSORY unter einem Multitasker läuft. Der Wert 1
  689.                       bedeutet, daß nach jedem Taktzyklus (Abfrage des
  690.                       Tastaturpuffers/Modempuffers und Ausgabe der nächsten
  691.                       Animationssequenz) solche "Timeslices" freigegeben
  692.                       werden. Beim Wert 2 geschieht dies nur jeden zweiten,
  693.                       bei 3 nur jeden dritten Taktzyklus. Voreingestellt ist
  694.                       der Wert 1. Wird eine 0 angegeben, so werden überhaupt
  695.                       keine "Timeslices" freigegeben. Mit Hilfe dieses
  696.                       Schlüsselwortes kann mehr Zeit für einen CURSORY-Task
  697.                       unter Multitaskern reserviert werden. Dies ist z. B.
  698.                       dann sinnvoll, wenn viele andere Tasks im Hintergrund
  699.                       laufen und dadurch eine evtl. vorhandene Animation
  700.                       "abbremsen". Die optimale Einstellung ist systemabhängig
  701.                       und sollte ausprobiert werden. Wird kein Multitasker
  702.                       erkannt, so hat dieses Schlüsselwort keine Wirkung.
  703.  
  704.  ┌─────────────┐
  705.  │ Steuercodes │
  706.  └─────────────┘
  707.  
  708.  Alle Steuercodes können in Zusammenhang mit den Schlüsselwörtern "menu",
  709.  "help", "task", "printstart" und "printend" genutzt werden.
  710.  
  711.  Viele dieser Steuercodes benötigen eine sog. Start- und Endmarkierung (zwei
  712.  identische Zeichen, bei Farbänderung z. B. das Zeichen "@"). Vergessen Sie
  713.  aus Versehen die Endmarkierung, so wird der entsprechende Steuercode
  714.  ignoriert, was zu falschen Ergebnissen führen kann. Bitte prüfen Sie bei
  715.  Problemen, ob Sie überall die Endmarkierung der Steuercodes gesetzt haben.
  716.  
  717.  HINWEIS: Sollen Steuerzeichen AUSGEGEBEN werden, so müssen diese DOPPELT
  718.           angeben werden (siehe auch Kapitel "Ausgabe/Verwendung von
  719.           Steuerzeichen") in der Datei "CURSORY.DOK".
  720.  
  721.  ─────────────────────────────────────────────────────────────────────────────
  722.  
  723.  @a,b@ = Farbe ändern (für "menu")
  724.          a = Farbcode oder Farbmacro, wenn Menüpunkt NICHT angewählt
  725.          b = Farbcode oder Farbmacro, wenn Menüpunkt angewählt
  726.  
  727.  @a@   = Farbe ändern (für "help", "task", "printstart" und "printend")
  728.          a = Farbcode oder Farbmacro
  729.  
  730.          Farbcode = Hintergrundfarbe * 16 + Vordergrundfarbe
  731.          ───────────────────────────────────────────────────
  732.          0 = Schwarz, 1 = Blau, 2 = Grün, 3 = Türkis, 4 = Rot, 5 = Violett,
  733.          6 = Braun, 7 = Hellgrau, 8 = Dunkelgrau, 9 = Hellblau,
  734.          10 = Hellgrün, 11 = Helltürkis, 12 = Hellrot, 13 = Hellviolett,
  735.          14 = Gelb, 15 = Weiß
  736.          Wird der Wert 128 zum Farbcode addiert, so blinkt die
  737.          Vordergrundfarbe. Werte für die Hintergrundfarbe größer als 7
  738.          haben keine Wirkung.
  739.  
  740.          Farbmacros siehe Abschnitt "Farbmacros" weiter unten!
  741.  
  742.  %x,y% = Absolute Cursorposition ändern
  743.          x = X-Position
  744.          y = Y-Position
  745.          Haben x und/oder y den Wert 0, so wird die jeweilige Teilkoordinate
  746.          NICHT geändert. Es gibt zwei Macros, die anstelle von x bzw. y
  747.          verwendet werden können: - STARTX
  748.                                     Die X-Position, die vor dem CURSORY-Start
  749.                                     aktuell war
  750.                                   - STARTY
  751.                                     Die Y-Position, die vor dem CURSORY-Start
  752.                                     aktuell war
  753.  
  754.  &Xx&  = Relative Cursorposition ändern
  755.          X = L (Left), R (Right), U (Up) oder D (Down)
  756.          x = relative Verschiebung
  757.  
  758.  ^TEXTMACRO^   = Ausgabe eines ProBoard-kompatiblen Textmacros, das während
  759.                  der Laufzeit durch verschiedene, spezifische Informationen
  760.                  ersetzt wird (Textmacros siehe Abschnitt "Textmacros" weiter
  761.                  unten!)
  762.  
  763.  ~DATEINAME~   = Ausgabe einer ASCII-/ANSI-/AVATAR-Datei (Angabe des
  764.                  Dateinamens OHNE Erweiterung). Die Datei, die sich im
  765.                  ProBoard-TXTFILES-Verzeichnis befinden muß, wird SOFORT
  766.                  ausgegeben, sobald dieser Steuercode gefunden wird (es sei
  767.                  denn, sie wird nicht gefunden)
  768.  
  769.  $PEX$         = Das angegebene PEX, das sich im ProBoard-PEX-Verzeichnis
  770.                  befinden muß, wird aufgerufen. Mit Hilfe dieser Möglichkeit
  771.                  können Sie Ihre eigenen Programme während der Laufzeit
  772.                  aufrufen
  773.  
  774.  _VERZÖGERUNG_ = Verzögerung der Ausgabe. Wird dieser Steuercode gefunden,
  775.                  so wird, je nach Wert von VERZÖGERUNG, die Ausgabe für eine
  776.                  bestimmte Zeit "angehalten". Mit Hilfe dieser Möglichkeit
  777.                  könnten zum Beispiel sog. "Fading"-Effekte realisiert werden.
  778.                  Ein Wert von 18 verzögert ca. 1 Sekunde
  779.  
  780.  *     = Cursor an der AKTUELLEN Position (NUR auf FREIEM Hintergrund!)
  781.          verschwinden lassen (siehe auch CSI-Schlüsselwort "hide")
  782.  
  783.  ⁿ     = (ASCII 252) Bildschirm löschen, vorausgesetzt der User hat das
  784.          "CLRSCR"-Flag gesetzt
  785.  
  786.  ²     = (ASCII 253) Findet CURSORY irgendwo dieses Zeichen, so wird der User
  787.          SOFORT rausgeschmissen :-)
  788.  
  789.  ┌────────────┐
  790.  │ Farbmacros │
  791.  └────────────┘
  792.  
  793.  Farbmacros können in Zusammenhang mit dem Steuerzeichen "@" überall dort
  794.  verwendet werden, wo "normale" Farbcodes auch zulässig sind.
  795.  Die Angabe erfolgt in der Form VORDERGRUNDFARBE-HINTERGRUNDFARBE-BLINK,
  796.  die Macros werden jeweils durch ein Bindestrich ("-") getrennt.
  797.  ALLE Macros sind OPTIONAL und FORMLOS. Die Farbe SCHWARZ kann weggelassen
  798.  werden. Einige Beispiele (in Klammern die gleichbedeutenden Farbcodes):
  799.  
  800.  blau-schwarz-blink (129)      blau (1)            blue-schwarz (1)
  801.  BLAU-Schwarz (1)              blau--blink (129)   gelb-rot (78)
  802.  blau - schwarz (1)            -blau (16)
  803.  b l a u - s c h w a r z (1)   blue-black (1)
  804.  
  805.  Hinweis: Deutsche und englische Farbmacros und Farbcodes können durchaus
  806.           gemischt werden. Ein Farbmacro oder Farbcode mit einem Wert größer
  807.           als 7 bei der Hintergrundfarbe hat keine Wirkung.
  808.  
  809.  Alle gültigen Farbmacros (DEUTSCH/ENGLISCH):
  810.  
  811.  Farbmacro             Farbcode   Farbmacro                   Farbcode
  812.  ──────────────────────────────   ────────────────────────────────────
  813.  SCHWARZ, BLACK        0          DUNKELGRAU, DARKGRAY        8
  814.  BLAU, BLUE            1          HELLBLAU, LIGHTBLUE         9
  815.  GRUEN, GREEN          2          HELLGRUEN, LIGHTGREEN       10
  816.  TUERKIS, CYAN         3          HELLTUERKIS, LIGHTCYAN      11
  817.  ROT, RED              4          HELLROT, LIGHTRED           12
  818.  VIOLETT, MAGENTA      5          HELLVIOLETT, LIGHTMAGENTA   13
  819.  BRAUN, BROWN          6          GELB, YELLOW                14
  820.  HELLGRAU, LIGHTGRAY   7          WEISS, WHITE                15
  821.                                   BLINK                       128
  822.  
  823.  ┌────────────┐
  824.  │ Textmacros │
  825.  └────────────┘
  826.  
  827.  Textmacros können linksbündig, rechtsbündig oder zentriert ausgegeben werden.
  828.  
  829.  Ohne Zentrierung:       ^textmacro^
  830.  Linksbündig:            ^textmacro:20^
  831.  Rechtsbündig:           ^textmacro:-20^
  832.  Zentriert:              ^textmacro::20^
  833.  
  834.  ADDRESS1                Adresse des Users, 1. Teil
  835.  ADDRESS2                Adresse des Users, 2. Teil
  836.  ADDRESS3                Adresse des Users, 3. Teil
  837.  BAUD                    Baudrate
  838.  BBSLOCATION             Standort der Mailbox
  839.  BBSNAME                 Name der Mailbox
  840.  BBSPHONE                Telefonnummer der Mailbox
  841.  BIRTHDATE               Geburtstag des Users
  842.  CIL                     CURSORY KERNEL INFO
  843.  CITY                    Wohnort des Users
  844.  COUNTRY                 Land des Users
  845.  CURFILEAREA#            Nummer der aktuellen "Filearea"
  846.  CURFILEAREA             Name der aktuellen "Filearea"
  847.  CURFILEGROUP#           Nummer der aktuellen "Filegroup"
  848.  CURFILEGROUP            Name der aktuellen "Filegroup"
  849.  CURMENU                 Name des aktuellen Menüs
  850.  CURMSGAREA#             Nummer der aktuellen "Messagearea"
  851.  CURMSGAREA              Name der aktuellen "Messagearea"
  852.  CURMSGGROUP#            Nummer der aktuellen "Messagegroup"
  853.  CURMSGGROUP             Name der aktuellen "Messagegroup"
  854.  DATAPHONE               Datentelefonnummer des Users
  855.  DATE                    Aktuelles Datum
  856.  DOWNLOADLIMIT           KB Download-Limit des Users pro Tag
  857.  EXPIRATIONDATE          "Expiration-Date"
  858.  FAXPHONE                FAX-Telefonnummer des Users
  859.  FIRSTLOGIN              Datum des ersten "Logins" des Users
  860.  FIRSTNAME               Vorname des Users
  861.  FLAGANSI                +/- = Ansi eingeschaltet/ausgeschaltet
  862.  FLAGAVATAR              +/- = Avatar eingeschaltet/ausgeschaltet
  863.  FLAGAVTPLUS             +/- = Avt/0+ eingeschaltet/ausgeschaltet
  864.  FLAGCLEARSCREEN         +/- = Bildschirmlöschen eingeschaltet/ausgeschaltet
  865.  FLAGFSED                +/- = Fullscreen-Editor eingeschaltet/ausgeschaltet
  866.  FLAGHOTKEYS             +/- = Hotkeys eingeschaltet/ausgeschaltet
  867.  FLAGIBM                 +/- = IBM-Zeichensatz eingeschaltet/ausgeschaltet
  868.  FLAGMOREPROMPT          +/- = "Moreprompt" eingeschaltet/ausgeschaltet
  869.  FULLTIME                Aktuelle Uhrzeit (inklusive Sekunden!)
  870.  HANDLE                  "Handle" (Pseudo, Alias) des Users
  871.  ID                      "ID" (Level-Kurzbeschreibung) des Users
  872.  INACTIVITYTIME          "Inactivity-Time"
  873.  INFO                    CURSORY-Versionsnummer
  874.  KBDOWNLOADED            KB Download (gesamt) des Users
  875.  KBUPLOADED              KB Upload (gesamt) des Users
  876.  KBUSEDTODAY             KB Download (heute) des Users
  877.  LANGUAGE                Verwendete Sprache des Users
  878.  LASTDATE                Datum des letzten Anrufs des Users
  879.  LASTNEWFILESCHECK       Datum des letzten "Newfilecheck" des Users
  880.  LASTPASSWORDCHANGE      Datum der letzten Paßwortänderung des Users
  881.  LASTTIME                Uhrzeit des letzten Anrufs des Users
  882.  LEVEL                   Level des Users
  883.  MAXSYSOPPAGES           Anzahl der erlaubten Sysop-Chatversuche
  884.  MINUSEDTODAY            Heutige Onlinezeit (Minuten) des Users
  885.  MNUDIR                  Pfad zu den *.PBM-Dateien
  886.  MSGDIR                  Pfad zur "Messagebase"
  887.  NAME                    Name des Users
  888.  NEWUSERLEVEL            Level für neue User
  889.  NLDIR                   Nodelisten-Verzeichnis
  890.  NODE                    Aktuelle Nodenummer
  891.  NUMCALLS                Anzahl der bisherigen Anrufe des Users
  892.  NUMDOWNLOADS            Anzahl der bisherigen Downloads des Users
  893.  NUMFILEAREAS            Anzahl der "Fileareas"
  894.  NUMMSGAREAS             Anzahl der "Messageareas"
  895.  NUMNODES                Anzahl der Nodes des Systems
  896.  NUMPOSTED               Anzahl der geschriebenen Nachrichten des Users
  897.  NUMUPLOADS              Anzahl der bisherigen Uploads des Users
  898.  NUMUSERS                Anzahl der User des Systems
  899.  PASSWORD                Paßwort des Users
  900.  PEXDIR                  PEX-Verzeichnis
  901.  PREVUSER                Name des vorherigen Users
  902.  PROTOCOLHOTKEY          Hotkey des voreingestellten Protokolls des Users
  903.  PROTOCOLNAME            Name des voreingestellten Protokolls des Users
  904.  PVTDIR                  Privat-Upload-Verzeichnis des Users
  905.  SCREENLENGTH            Anzahl der dargestellten Zeilen
  906.  SCREENWIDTH             Anzahl der dargestellten Spalten
  907.  STARTDIR                "Startup-Path"
  908.  STATE                   Bundesland des Users
  909.  SYSDIR                  ProBoard-Systemverzeichnis
  910.  SYSOPNAME               Name des Sysops
  911.  TIME                    Aktuelle Uhrzeit
  912.  TMLEFT                  Heutige Restzeit des Users
  913.  TMLIMIT                 Tägliches Zeitlimit des Users
  914.  TMONLINE                Heutige Onlinezeit des Users
  915.  TOTALTIMEUSED           Gesamtzeit des Users im System
  916.  TXTDIR                  Pfad zu den ASCII-/ANSI-/AVATAR-Dateien
  917.  UPDIR                   Upload-Verzeichnis
  918.  USERREC                 Nummer des Users in der Datei USERS.BBS
  919.  VERSION                 ProBoard-Versionsnummer
  920.  VOICEPHONE              Voice-Telefonnummer des Users
  921.  %UMGEBUNGSVARIABLE      Gibt den Inhalt einer mittels "SET VARIABLE="
  922.                          definierten Umgebungsvariable aus
  923.  
  924.  ┌───────────────────────────────────────────┐
  925.  │ Spezialcodes für "hotkey" und "globalkey" │
  926.  └───────────────────────────────────────────┘
  927.  
  928.  Mit Hilfe dieser Spezialcodes können nachfolgende Tasten als Hotkey
  929.  genutzt werden.
  930.  
  931.  SPACE           #32
  932.  RETURN          #13
  933.  ESC             #27
  934.  Cursor-Links    #19200
  935.  Cursor-Rechts   #19712
  936.  Cursor-Hoch     #18432
  937.  Cursor-Runter   #20480
  938.  POS1            #18176
  939.  ENDE            #20224
  940.  
  941.  Beispiele:      hotkey #27
  942.                  globalkey #19200, <
  943.                  globalkey #19712, >
  944.  
  945.  ┌─────────────────┐
  946.  │ Fehlermeldungen │
  947.  └─────────────────┘
  948.  
  949.  ERROR -> No CSI-file defined
  950.           Das Programm wurde in der DATA-Zeile des Menüeditors ohne
  951.           Parameter aufgerufen
  952.  
  953.  ERROR -> No menu or task defined
  954.           In der angegebenen CSI-Datei wurde weder ein Menüpunkte noch eine
  955.           Animationssequenz definiert
  956.  
  957.  ERROR -> Could not open PBM-file
  958.           Nach Auswahl eines Menüpunktes wird automatisch geprüft, ob
  959.           dieser evtl. durch Flags, einen Mindestlevel oder sonstige
  960.           im Menüeditor definierte Einschränkungen gesperrt ist. Diese
  961.           Informationen sind in sog. "PBM"-Dateien enthalten. Wird
  962.           CURSORY aus einer Sprachdatei heraus aufgerufen, so existiert
  963.           keine zugehörige PBM-Datei. In diesem Fall muß die Prüfung
  964.           manuell ausgeschaltet werden, um diese Fehlermeldung zu
  965.           unterdrücken. Dies geschieht mit Hilfe des globalen CSI-
  966.           Schlüsselwortes "nocheck"
  967.  
  968.  ERROR -> Could not open GLOBAL.PBM
  969.           Die Datei GLOBAL.PBM konnte nicht gefunden werden. Erstellen
  970.           Sie ein globales Menü oder verwenden Sie das CSI-
  971.           Schlüsselwort "noglobalcheck"
  972.  
  973.  ERROR -> Out of memory
  974.           Es ist zuwenig Speicher vorhanden, um alle in der CSI-Datei
  975.           definierten Menüpunkte / Animationssequenzen darzustellen
  976.  
  977.  ERROR -> Could not open CSI-file
  978.           Die CSI-Datei wurde nicht gefunden. Dieser Fehler tritt auf,
  979.           wenn die angegebene Datei nicht existiert oder der Dateiname
  980.           und/oder die Pfadangabe nicht korrekt geschrieben sind.
  981.           Wird dieser Fehler trotz mehrmaliger Überprüfung dennoch
  982.           angezeigt, so sollte in der DATA-Zeile der Dateiname und
  983.           der KOMPLETTE Pfad INKLUSIVE Laufwerkskennung angegeben
  984.           werden (weitere Tips finden Sie in der Datei "FAQ.DOK")
  985.  
  986.  ERROR -> Unknown keyword in line x
  987.           In der angegeben Zeile der CSI-Datei befindet sich ein
  988.           unbekanntes Schlüsselwort. Prüfen Sie, ob Sie das
  989.           Schlüsselwort auch wirklich korrekt geschrieben haben.
  990.           Weitere Tips finden Sie in der Datei "FAQ.DOK"
  991.  
  992.  ERROR -> Too many "menu" defined
  993.           Es wurden zuviele Menüpunkte definiert
  994.  
  995.  ERROR -> Too many "task" defined
  996.           Es wurden zuviele Animationssequenzen definiert
  997.  
  998.  ERROR -> Too many global hotkeys defined
  999.           Es wurden zuviele globale Hotkeys definiert
  1000.  
  1001.  ERROR -> " expected in line x
  1002.           In der angegebenen Zeile fehlt irgendwo das Zeichen "
  1003.  
  1004.  ERROR -> Too few parameters in line x
  1005.           In der angegebenen Zeile fehlen hinter dem CSI-Schlüsselwort
  1006.           ein bzw. mehrere Parameter
  1007.  
  1008.  ERROR -> Too many parameters in line x
  1009.           In der angegebenen Zeile befinden sich hinter dem CSI-
  1010.           Schlüsselwort zuviele Parameter. Weitere Informationen über
  1011.           mögliche Ursachen dieser Fehlermeldung finden Sie in der Datei
  1012.           "FAQ.DOK"
  1013.  
  1014.  ERROR -> Keyword outside block in line x
  1015.           In der angegebenen Zeile befindet sich ein LOKALES CSI-
  1016.           Schlüsselwort, dem kein Menüpunkt oder keine
  1017.           Animationssequenz zugewiesen werden konnte. Bitte prüfen Sie,
  1018.           ob Sie ÜBER diesem Schlüsselwort evtl. vergessen haben, die
  1019.           Schlüsselwörter "menu" oder "task" zu verwenden
  1020.