char* MTextPrompt (const char *title, const char *msg, const char *text, int w, int h, const char *ok_btn, const char *canc_btn)

Displays a modal prompt window for a multi line text input

Documentation

Displays a modal prompt window for a multi line text input. This dialog window allows the program to block its flow, waiting for the user input a multi line text. The arguments 'w' and 'h' specify the width and height of the Edit field object in character units.

Returns:
The NULL value is returned if the users selects the Cancel button, a pointer to a new allocated buffer containing the input value is returned otherwise. The program is responsible for freeing this buffer using free().
Parameters:
title - The text displayed in the window's title bar.
msg - A multi line text string that will be displayed centered in the window.
text - The intial text value displayed.
w - The edit window width in character units.
h - The edit window height in character units.
ok_btn - Text to be displayed in the Ok-button.
canc_btn - Text to be displayed in the Cnacel-button.

alphabetic index hierarchy of classes


MGUI Copyright 1996-2000 Vincenzo Morello

generated by doc++