WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
xcall I_PROMPT(window_id, field_spec, prompt)
The ID of the input window in which you want the prompt to be displayed. (n)
The specification for the field the prompt is associated with. (a)
The prompt to display. (a)
I_PROMPT sets the prompt for a field.
- If a prompt has already been assigned to the field, I_PROMPT changes the prompt to prompt. Note that the length of prompt must be less than or equal to the length of the original prompt for the field.
- If no prompt has been assigned to the field, but a number was specified for the PROMPT qualifier for .FIELD, the D_FIELD_PROMPT qualifier for IB_FIELD, or the prompt field in Repository (if the field is imported from a repository), I_PROMPT sets the prompt to prompt. Note that the number of characters in prompt must be less than or equal to the number specified for the qualifier.
- If no prompt or number was specified for the PROMPT qualifier for .FIELD, the D_FIELD_PROMPT qualifier for IB_FIELD, or the prompt field in Repository, I_PROMPT cannot set a prompt for the field.
For more information on setting prompts, see PROMPT, NOPROMPT .
In the following, a number is specified for the PROMPT qualifier for .FIELD, so the field fld1 has no prompt, but space for 20 characters has been allocated for a prompt.
.input inp, 5, 40 .field fld1, a10, prompt(20) .end
The following call assigns a prompt to fld1:
xcall i_prompt(id, "fld1", "This is field one")