|
WSupported on Windows
|
USupported on Unix
|
VSupported on OpenVMS
|
NSupported in Synergy .NET
|
xcall I_PROMPT(window_id, field_spec, prompt)
Arguments
window_id
The ID of the input window in which you want the prompt to be displayed. (n)
field_spec
The specification for the field the prompt is associated with. (a)
prompt
The prompt to display. (a)
Discussion
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 .
Examples
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")
