int prompt_generic ( char *message, char *buf, int g_type, char *aux_string )

char *message;       // prompt message string

char *buf;           // address of buffer to receive generic item

int g_type;          // generic type

char *aux_string;    // auxiliary string

Synopsis

#include "silver.h"

The prompt_generic function displays a pop-up box containing items specified by g_type and aux_string , and allows the user to select one. The prompt specified by message is displayed on the first line of the dialog area.

Parameters

message is a null-terminated string with three components, separated by vertical bars ('|'), as follows:

"<text1>|<text2>|<text3>"

where:

<text1> is the text that appears in the title.

<text2> is the text that appears beneath the title. If text is "*", then no text will be displayed.

<text3> is the prompting message that is to be used when direct keyboard entry is allowed; if this text is "*", no keyboard entry is allowed.

buf is the address of a character buffer that is to receive the generic item. g_type specifies the generic data set type of data to collect. aux_string is an auxiliary string appropriate to g_type .

Return Value

If the user selects an item, then the item is copied into buf and prompt_generic returns 1; otherwise 0 is returned.

Comments

See the topic "Generic data sets" for more information on g_type and aux_string.

See Also

collect_generic, get_generic, pm_generic