| Description | ||||||||
| Sets up a menu containing buttons defined by an array of strings. The function makes the menu active, closes it after a specified number of selections (or quit), and returns a list of the selected strings.
This function affects Menu-Manager (mode-specific) menus only. This function is intended for menus that depend on run-time data. You do not need to define a menu file for this type of menu, and you do not attach actions to its buttons using ProMenubuttonActionSet(). |
||||||||
| Synopsis | ||||||||
| #include <ProMenu.h> | ||||||||
| ProError | ProMenuStringsSelect | ( | ||||||
| ProName title | ||||||||
| /* (In) | ||||||||
| A wide string containing the menu title to be displayed. | ||||||||
| */ | ||||||||
| wchar_t** strings | ||||||||
| /* (In) | ||||||||
| A list of wide strings defining the menu buttons, terminated by an empty string. Individual strings can be no longer than PRO_NAME_SIZE-1. | ||||||||
| */ | ||||||||
| int max_count | ||||||||
| /* (In) | ||||||||
| The maximum number of selections allowed. Use the value PRO_VALUE_UNUSED for an unlimited number of selections. | ||||||||
| */ | ||||||||
| wchar_t** help | ||||||||
| /* (In) | ||||||||
| A list of wide strings defining the one-line help strings for the menu buttons. | ||||||||
| */ | ||||||||
| wchar_t*** selected | ||||||||
| /* (Out) | ||||||||
| The wide strings selected by the user. The function allocates memory for these strings, and reuses the memory on subsequent calls. | ||||||||
| */ | ||||||||
| int* n_selected | ||||||||
| /* (Out) | ||||||||
| The number of strings selected. | ||||||||
| */ | ||||||||
| ) | ||||||||
| Returns | ||||||||
|
||||||||
| See Also | ||||||||
| ProMenubuttonActionSet | ||||||||