messagebox
Previous: menubar
Next: mkdir
6.2.85. messagebox
displays a messagebox on the host system's screen
SYNOPSIS
INCLUDE 'winlib' messagebox(Win, Options, Text, Title, Return)
SYNTAX
messagebox(Win, Options, Text, Title, Return) (i,i,i,i,o)
ARGUMENTS
integer(Win) (i) Handle of the parent window.
integer(Options) (i) Display options, defined in winlib.h.
string(Text) (i) Text of the message.
string(Title) (i) Title displayed in hte message boxes caption.
integer(Return) (o) Value of the user's selection.
DESCRIPTION
Displays a message box with the caption text Title and the contents Text. Options control the displayed pushbuttons. Constants are defined in
winlib.h
. The predicate suspends execution of the process until the user has selected a button to
close the message box. The Return value contains the selection.
The parent window is activated when the messagebox is displayed. If a process does not
own a window, window 0 (the console) can be given as parent.
Note: The exact implementation is host server dependent. Although a message box exists on all windows based hosts, the meaning and interpretation of the constants in winlib.h may differ.
EXAMPLE
gotowindow(Win), Value is mb_iconstop + mb_okcancel, messagebox (Win, Value, "do it?", "Prolog", Return), Return = idok, doit.
ERRORS
No runtime errors
LAYERS
prolog-process, client-server, object
RELATED PREDICATES
BAP Online Manuals : Library Reference : Library by Name : messagebox
Previous: menubar
Next: mkdir