Dialogs & Prompts

Dialogs

Dialogs in TDE are quite simple, consisting only of edit fields and check boxes. Use Tab/PgDn and Shift+Tab/PgUp to switch between edit fields and the function keys to toggle check boxes; GotoMark<N> will move to the <N>th edit field. To accept the values press Enter; Esc will cancel the dialog. Cancelling a dialog will not necessarily restore the original values (for example, turning on RegX in DefineSearch, then cancelling, will still leave the RegX option on the next time).

When a dialog is opened from a macro (either recording or playing), all the check boxes will be cleared and the focus will be set to the first edit field (however, a macro definition can include the flag UsesDialog to prevent this).

Prompts

Prompts (and edit fields) can be edited in much the same way as any text in the editor. If the first key is a character, DeleteChar or StreamDeleteChar, the initial answer will be erased. The following functions have the same meaning as their main editor counterpart:

BackSpace	EndOfLine	Transpose
BegOfLine	SetDirectory	WordDelete
CharLeft	StreamCharLeft	WordDeleteBack
CharRight	StreamCharRight	WordLeft
DelBegOfLine	StreamDeleteChar	WordRight
DelEndOfLine	ToggleOverWrite
DeleteChar	ToggleSearchCase

The following functions are also available:

AbortCommand	cancel the prompt, keep original answer
BackTab	filename completion
BegNextLine	copy the string from the current window
CopyToClipboard	copy the answer to the clipboard
CutToClipboard	copy the answer to the clipboard
DeleteLine	erase the answer, but add it to the history
Help	display help for the command, if any
KopyToClipboard	copy the answer to the clipboard
LineDown	retrieve the next answer from the history
LineUp	retrieve the previous answer from the history
NextLine	copy the word from the current window
PasteFromClipboard	copy the first line from the clipboard
Rturn	accept the answer and add it to the history
ScrollDnLine	complete next entry from the history
ScrollUpLine	complete previous entry from the history
Tab	filename completion
ToggleCWD	if the DisplayCWD option is off, display the current directory above the prompt, or at the bottom of the screen in a dialog

The clipboard functions are only available to tdep.exe and tdew.exe.

Copying the word or string from the current window, or the line from the clipboard, will use the insert or overwrite mode. If it is the first key pressed, the current answer will be erased.

Filename completion is only available to functions that expect a filename. If the answer contains wildcard characters, each matching filename will become the answer. If there are no wildcards, the entire answer will form the prefix of a filename. The first completion will add the characters common to all matching files; each subsequent completion will be the filename itself. Once all names have been displayed, the common characters will again be shown.

History completion will search the history for a line that matches the answer up to the current cursor position. The search mode case will be used.

Prompts that expect a filename (more specifically, any prompt that uses the file history) will recognise a leading `~/' and substitute it for TDE's home directory (TDEHOME, HOME or the same path as the executable).