Enterfunction Prompts

Prompts let you know that you have an enterfunction active in a window. A prompt string (supplied to the enterfunction) is displayed on the CIW prompt line whenever you enter data into a window that has an enterfunction active. Prompt strings should be informative and let users know what the state of the enterfunction is, as well as what they should enter.

If an enterfunction requires multiple points, the caller supplies a list of prompt strings, one for each point. The prompt displayed in the CIW advances one item in the list of strings as each point is entered. Suppose that an enterfunction requires two points and the prompt list provided is

’("Enter First Point" "Enter Second Point") 

Before you enter a point, the prompt line would say

"Enter First Point"

After you have entered the first point, the next string is displayed

"Enter Second Point"

If you delete a point, the previous prompt message is displayed. If the list of prompt strings is exhausted before you enter all the points, the last prompt message continues to display. Extra prompt strings are ignored. If a prompt list is not supplied, prompts are not displayed. (This practice is not recommended.)

Return to top