Virtual Key Names464 TeemTalk Virtual Key Name FunctionsReading Text Froma File or DeviceThe following command format is used to read a string from a file ordevice (e.g. COM1) and push it into the keyboard buffer as if typed.This can be used, for example, to trigger a bar code reader, read backthe code and enter it as if typed at the keyboard.max length,retries,terminationcharwhere:name is either the name of the file or the name of the device to beread from.max length specifies the maximum number of characters to beread before terminating. Entering 0 will give a default of 512 char-acters.retries specifies the number of 100ms retries before terminating.Entering 0 or 999 is taken as no time out (wait forever). A negativevalue prevents keyboard intervention and the value is made positive.termination char is the decimal value of the ASCII characterused to terminate the command. Entering 0 will give a default of 26(EOF).A read can be terminated by the following four conditions:• the maximum number of characters being read,• the termination character being read (this is inhibited by a 0value),• the number of specified retries has been reached (this is inhibitedby a 0 or 999 value),• the user presses a key (this is inhibited by a negative timeout).For example, the following command will read up to 20 characters,end at the first CR (carriage return) character, never timeout butallow a key press to cancel the read:20,0,13
