PromptForYesNoAllOrSkip

Sends a multi-option prompt to the specified screen.

Library:LibC
Classification:NetWare OS
Service:Screen Support

Syntax

  #include <screen.h> 
   
  int PromptForYesNoAllOrSkip (
     scr_t         scrID,
     int           linesToProtect,
     uint32_t      defaultValue,
     const char   *promptText, 
     ... );

Parameters

scrID

(IN) Specifies the screen to receive the prompt.

linesToProtect

(IN) Specifies the number of lines that have to be protected from the current input row upwards. Thus, if linesToProtect is 2 and the current input row number is 4, rows 3 and 4 have to protected.

defaultValue

(IN) Specifies the default value for this prompt with one of the following:

Constant

Value

Description

SCR_PROMPT_ANSWER_NO

0

The no response is marked as the default.

SCR_PROMPT_ANSWER_YES

1

The yes response is marked as the default.

SCR_PROMPT_ANSWER_SKIP

2

The skip response is marked as the default.

SCR_PROMPT_ANSWER_ALL

3

The all response is marked as the default.
promptText

(IN) Points to the text of the question that can be answered with a yes, no, all, or skip response.

...

(IN) Points to an argument for a printf conversion specifier. The number of arguments is determined by the promptText string.

Return Values

Returns the response of the user: 0 for no, 1 for yes, 2 for skip, and 3 for all.

See Also