inkey

inchar (STRING*);

inkey (STRING*);

Trägt Tastatureingaben in den angegebenen String ein. Das lokale Tastaturlayout wird aktiviert. inchar() wartet bis eine Taste gedrückt ist, ließt sie in den Stirng und liefert ihren ASCII-Wert zurück. inkey() liest solange Zeichen in den String bis die Eingabe mit [Eingabe] oder [Tab] beendet wird.

Parameter:

STRING* - String-Pointer, der die Tastatureingabe erhalten soll oder NULL, um lediglich den Tastenwert zurückzuliefern.

Rückgabewert:

1	Eingabe beendet, entweder indem inkey_active auf 0 gesetzt wurde, oder weil gleichzeitig eine andere Tastatureingabe aktiv war
9	Eingabe mit [Tab] beendet
13	Eingabe mit [Eingabe] beendet
27	Eingabe mit [Esc] abgebrochen
72	Eingabe mit [Cursor Up] abgebrochen
73	Eingabe mit [Bild Auf] abgebrochen
80	Eingabe mit [Cursor Down] abgebrochen
81	Eingabe mit [Bild Ab]abgebrochen
andere	ASCII-Wert der gedrückten Taste.

Modifiziert:

STRING	Der String erhält die Tastatureingabe
inkey_active	Während der Eingabe auf 1 (inkey) oder 2 (inchar), sonst 0.

Bemerkungen:

Der Text der inkey()-Eingabe läßt sich während des Eingebens bearbeiten und zwar über die Tasten BackSpace], [Entf], [Rechts], [Links], [Pos1] und [Ende]. Die ursprüngliche Länge des Strings wird nicht überschritten. Durch Drücken von [Esc], [Hoch], [Runter], [Bild hoch], [Bild runter] or [F1]..[F11] wird inkey() abgebrochen. Daraufhin wird der vorhergehende Inhalt des Strings wieder hergestellt und der Scan-Code der Taste zurückgegeben.
Erscheint der String in einem auf dem Bildschirm angezeigten TEXT-Objekt, sind sowohl die Eingabe als auch der Cursor sichtbar. Der Cursor ist das Zeichen Nr. 127 aus einem Bitmap-Font bzw. das Zeichen 59 (Unterstreichung '_') aus einem True-Type-Font. Die str_cursor-Funktion lässt sich dazu verwenden, die gegenwärtige Cursor-Position zu bekommen, während der String editiert wird.
Die Eingabe per Tastatur lässt sich extern durch Setzen der inkey_active-Variablen auf 0 abbrechen.
Tastenfunktionen (on_a etc) sind während der Eingabe über Tastatur inaktiv und game_save/game_load-Anweisungen werden nicht ausgeführt.
Die Funktionen führen interne wait()-Aufrufe durch und lassen sich daher nicht von externen Sprachen benutzen. Sie werden nicht in acknex.dll exportiert.

Beispiele (lite-C):

TRING* entry_str = "                      "; // long empty string
...
var key = inkey(entry_str); // wait until [enter] pressed
if (key == 13)
  process_entry(entry_str); 
...

STRING* string1 = "";
STRING* string2 = "";
...
while(1) {
   if (inchar(string1) == 13) break;
   str_cat(string2,string1);
}

Siehe auch:

inkey_active, str_cursor, key_a,...,key_z, on_, key_for_string, str_for_key, key_set

► Aktuelle Version Online