ckitem(1M) ckitem(1M)
NAME
ckitem, erritem, helpitem - Generiert ein Menü; fordert zur Eingabe
eines Menüpunktes auf und gibt ihn zurück
SYNTAX
/usr/bin/ckitem [-Q] [-W width] [-uno] [-f file] [-l label]
[[-i invis] [, ...]] [-m max] [-d default] [-h help]
[-e error] [-p prompt] [-k pid [-s signal]]
[choice [...]]
/usr/sadm/bin/erritem [-W] [-e error] [choice [...]]
/usr/sadm/bin/helpitem [-W] [-h help] [choice [...]]
BESCHREIBUNG
ckitem generiert ein Menü und fordert den Benutzer dazu auf, aus dem
Menü einen Punkt auszuwählen. Dann überprüft das Kommando die Eingabe
des Benutzers auf ihre Gültigkeit. Zusätzlich kann unter anderem eine
Eingabeaufforderung definiert werden, auf die hin ein Menüpunkt einge-
geben werden muß, ebenso ein Hilfetext, eine Fehlermeldung und ein
Standardwert, der zurückgegeben wird, wenn der Benutzer die Eingabe-
aufforderung mit <RETURN> beantwortet.
Standardmäßig wird das Menü so formatiert, daß jedem Menüpunkt eine
Nummer vorausgeht und daß die Elemente, aus denen ein Menüpunkt
besteht, in Spalten auf dem Bildschirm erscheinen. Die Spaltenbreite
richtet sich nach dem längsten Menüpunkt. Die Menüpunkte werden alpha-
betisch angeordnet.
Meldungen dürfen höchstens 70 Zeichen lang sein und werden automatisch
formatiert. Zwischenräume in der Definition, auch das Neue-Zeile-
Zeichen, werden entfernt. Die Option -W unterdrückt die automatische
Formatierung. Beginnt oder endet die Definition einer Meldung mit
einer Tilde, wird an dieser Stelle der Standardtext eingesetzt, so daß
Standardtext und vom Benutzer definierter Text zusammen angezeigt wer-
den können.
Wenn keine Eingabeaufforderung, Hilfe- oder Fehlermeldung definiert
wird, wird die unter HINWEISE beschriebene Standardmeldung angezeigt.
Zwei visuelle Module sind mit dem Kommando ckitem verbunden, nämlich
erritem zur Formatierung und Anzeige einer Fehlermeldung und helpitem
zur Formatierung und Anzeige einer Hilfemeldung. Diese Module sollten
zusammen mit FML-Objekten benutzt werden. In diesem Fall definiert das
FML-Objekt die Eingabeaufforderung. Wenn in diesen Modulen choice
definiert wird, beschreiben die Meldungen den verfügbaren Menüpunkt
bzw. die Menüpunkte.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
ckitem(1M) ckitem(1M)
OPTIONEN
-Q Gibt an, daß quit nicht als gültige Antwort erlaubt ist.
-W Gibt an, daß Eingabeaufforderung, Hilfe- und Fehlermeldung auf
eine Zeilenlänge von width formatiert werden.
-u Gibt an, daß die Menüpunkte als Liste ohne Numerierung ange-
zeigt werden sollen.
-n Gibt an, daß die Menüpunkte nicht in alphabetischer Reihen-
folge angezeigt werden sollen.
-o Gibt an, daß nur ein Menü-Token zurückgegeben wird.
-f Definiert eine Datei mit dem Namen file, die eine Liste von
Menüpunkten enthält, die angezeigt werden sollen. Das Format
dieser Datei lautet: Token<Tabulator>Beschreibung. Zeilen, die
mit dem Zeichen # beginnen, gelten als Kommentar und werden
ignoriert.
-l Definiert einen label, der über dem Menü ausgegeben wird.
-i Definiert verdeckte Menüpunkte, die auf dem Menü nicht ange-
zeigt werden. Wenn beispielsweise "alle" als verdeckter Menü-
punkt benutzt wird, so bedeutet dies, daß "alle" zwar eine
gültiger Menüpunkt ist, aber nicht auf dem Menü erscheint. Es
können beliebig viele verdeckte Menüpunkte definiert werden.
Auf verdeckte Menüpunkte sollte der Benutzer entweder über die
Eingabeaufforderung oder in einer Hilfemeldung aufmerksam
gemacht werden.
-m Gibt an, wieviele Menüpunkte höchstens erlaubt sind.
-d Definiert default als Standardwert. Der Standardwert wird
nicht auf seine Gültigkeit überprüft und braucht daher keinen
Kriterien zu entsprechen.
-h Definiert help als Hilfemeldung.
-e Definiert error als Fehlermeldung.
-p Definiert prompt als Meldung zur Eingabeaufforderung.
-k Gibt an, daß an die Prozeßnummer pid ein Signal gesendet wer-
den soll, wenn der Benutzer mit q abbricht.
-s Gibt an, daß an die Prozeßnummer pid, die mit der Option -k
definiert wurde, das Signal signal gesendet werden soll, wenn
der Benutzer quit wählt. Wird kein Signal angegeben, wird SIG-
TERM benutzt.
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
ckitem(1M) ckitem(1M)
choice Definiert die Menüpunkte. Die Menüpunkte sollten durch Zwi-
schenräume oder Neue-Zeile-Zeichen voneinander getrennt wer-
den.
DIAGNOSE
0 = Ausführung erfolgreich
1 = EOF (Dateiende) bei Eingabe
2 = Falsche Verwendung
3 = Abbruch durch Benutzer (quit)
4 = Keine Optionen zur Auswahl
HINWEISE
Der Benutzer kann die Nummer des gewünschten Menüpunktes eingeben,
wenn die Menüpunkte numeriert sind, oder er kann so viele Zeichen des
Namens des Menüpunktes eingeben, daß er dadurch eindeutig bestimmt
wird. Lange Menüs werden auf Seiten zu je 10 Zeilen aufgeteilt.
Wenn Menüpunkte sowohl in einer Datei (über die Option -f) als auch
auf der Kommandozeile definiert werden, werden sie in der Regel in
alphabetischer Reihenfolge angeordnet. Wird jedoch mit der Option -n
die alphabetische Sortierung unterdrückt, dann werden die in der Datei
definierten Menüpunkte zuerst und die auf der Kommandozeile definier-
ten Menüpunkte dahinter angeordnet.
Die standardmäßige Eingabeaufforderung für ckitem lautet:
Enter selection [?,??,q]:
(Auswahl eingeben [?,??,q]:)
Gibt man ein Fragezeichen ein, erscheint eine Hilfemeldung und dann
wieder die Eingabeaufforderung. Gibt man zwei Fragezeichen ein,
erscheint der Titel des Menüs, das Menü und die Eingabeaufforderung.
Die Standardfehlermeldung lautet:
ERROR - Does not match an available menu selection.
Enter one of the following:
- the number of the menu item you wish to select
- the token associated with the menu item
- partial string which uniquely identifies the token
for the menu item
- ?? to reprint the menu
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98
ckitem(1M) ckitem(1M)
(FEHLER - Entspricht keinem verfügbaren Menüpunkt.
Sie haben folgende Möglichkeiten:
- Geben Sie die Nummer des gewünschten Menüpunktes ein
- Geben Sie das Token zu dem Menüpunkt ein
- Geben Sie eine Zeichenkette ein, die das Token des Menüpunktes
eindeutig bestimmt
- Geben Sie ?? ein, damit das Menü nochmals angezeigt wird)
Die Standardhilfemeldung lautet:
Enter one of the following:
- the number of the menu item you wish to select
- the token associated with the menu item
- partial string which uniquely identifies the token
for the menu item
- ?? to reprint the menu
(Sie haben folgende Möglichkeiten:
- Geben Sie die Nummer des gewünschten Menüpunktes ein
- Geben Sie das Token zum Menüpunkt ein
- Geben Sie eine Zeichenkette ein, die das Token des Menüpunktes
eindeutig bestimmt
- Geben Sie ?? ein, damit das Menü nochmals angezeigt wird)
Ist die Option quit erlaubt und wird sie gewählt, wird q zusammen mit
dem Rückkehrcode 3 zurückgegeben.
Seite 4 Reliant UNIX 5.44 Gedruckt 11/98