PtMessageBox()

Pop up a message box

Synopsis:

int PtMessageBox( PtWidget_t *parent, 
                  char const *title,
                  char const *question, 
                  char const *font, 
                  char const *btn );

Library:

ph

Description:

This function displays the message specified by question, blocking input to the specified parent widget until the message has been acknowledged. If no parent is specified, blocking won't occur, but the message will persist until it's acknowledged. If specified, the parent widget must be a window.

The other arguments are:

title
The title of the dialog. If this argument is NULL, the dialog has no title bar.
font
The name of the font to use for the message, as created by PfGenerateFontName(). The default is TextFont09.
btn
The label to display in the dialog's button. The default is Ok.

This function returns immediately.

Returns:

0
Success.
-1
Failure occurred due to lack of memory.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

ApError(), PfGenerateFontName(), PtAlert(), PtNotice(), PtPrompt()

Dialog modules in the Working with Modules chapter of the Photon Programmer's Guide