Tell

Key

CTRL+T

Tell

Displays the message Press a key to tell about and waits for a keystroke. After you press a key or combination of keys, Tell brings up the Tell dialog box showing the name of the key and its assigned function in TOOLS.INI key-assignment format.

The key-assignment format is:

function:key

If the key is not assigned a function, Tell displays unassigned for the function name. See: Unassigned.

If you press a combination of keys, but Tell still shows the Press a key prompt (when you press SCROLL LOCK, for example), PWB is unable to recognize that combination of keys and you cannot use it as a key assignment.

Arg Tell (ALT+A CTRL+T)

Prompts for a key, then displays the name of the function or macro assigned to the key in one of these formats:

function:key macroname:=definition

Arg textarg Tell (ALT+A textarg CTRL+T)

Displays the definition of the macro named by textarg. If you specify a PWB function, Tell displays:

function:function

Meta ... Tell (F9 ... CTRL+T)

As above except Tell types the result into the current file rather than displaying it in a dialog box. This is how to discover the definition of any macro, including PWB macros.

Returns

TrueAssignment displayed or typed.

FalseNo assignment for the key or the specified name.

Update

In PWB 1.x, the prompt and results appear on the status bar; in PWB 2.00, the prompt and results appear in dialog boxes.

Remarks

Meta Tell is a convenient and reliable way of writing a key assignment when you are configuring PWB.

For example, if you want to execute the Curdate function (type today's date) when you press the CTRL, SHIFT, and D keys simultaneously, perform the following steps:

1.Go to an empty line in the [PWB] section of TOOLS.INI.

2.Execute Meta Tell (F9 CTRL+T).

Tell displays the message: Press a key to tell about.

3.Press the D, SHIFT, and CTRL keys simultaneously.

If you have not already assigned a function to this combination, Tell types:

unassigned:Shift+Ctrl+D

4.Select the word unassigned and type curdate.

5.If you want the assignment to take effect immediately, move the cursor to the line you've just entered and execute the Assign function (ALT+=).

You can use Meta Arg textarg Tell to recover the definition of a predefined PWB macro or a macro that you have not saved or entered into a file.

See

Assign, Record