IOgetNewTextNoEcho

Eingabe ab Fenstersystem holen ohne Echo.

IOgetNewTextNoEcho holt die nächste Eingabe von dem Fenstersystem ab, auch wenn sich noch Eingaben in einem Batchfile befinden. Wenn sich noch Eingaben in der Warteschlange befinden, werden diese NICHT berücksichtigt. Es wird statt dessen eine neue Zeile geholt und nach text kopiert. Dabei wird der Teil der Zeile, der ggf. nicht mehr in text passt, abgeschnitten und nicht geliefert. Der überstehende Teil wird weggeworfen und nicht bei nachfolgenden Aufrufen geliefert. Die Eingabe wird nicht im Ausgabefenster angezeigt, sie steht aber in der History der Eingabezeile zur Verfügung.

Parameter

root (PROOT)                                             [IN]

Handle auf die geöffnete Datenbank.

text (char *)                                              [OUT]

In diesen Pufferbereich wird die Eingabezeile ohne das abschließende <CR> kopiert. Wenn der Puffer zu klein ist, um die gesamte Zeile aufzunehmen, wird der Rest abgeschnitten. Der Puffer ist immer von einem ASCII-Null-Zeichen begrenzt.

len (int)                                                         [IN]

In len wird die Länge des Pufferbereichs mitgeteilt. Diese Angabe ist mit abschließendem NULL-Zeichen gerechnet. Wenn der Puffer nach dieser Angabe zu klein für die Eingabezeile ist, wird diese gekürzt.

Ergebnis

---

Deklaration

#include "ausgabe.h"

void DLLENTRY IOgetNewTextNoEcho(

     PROOT    root,

     char *      text,

     int         len

);