---

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

---