confirm
Displays a confirmation window and returns the value for the user's
choice.
Available in:
| Apps (win) |
Apps (char) |
Reportwriter |
RPC |
Standalone PL |
| X |
X |
X |
|
X |
Syntax
int confirm(title,msg[,default[,icon[,button]]])
string title, msg
int default, icon, button
Description
Displays a confirmation window with the title and
msg and returns the specified value.
|
default | (optional) specifies one of the following buttons.
|
| Mnemonic |
Value |
Description |
| confirm_no (default) | 0 | no button |
| confirm_yes | 1 | yes button |
| confirm_ok | 2 | ok button |
| confirm_cancel | 3 | cancel button |
| confirm_retry | 4 | retry button |
| confirm_abort | 5 | abort button |
| confirm_ignore | 6 | ignore button |
|
icon | (optional) specifies one of the following icons.
|
| Mnemonic |
Value |
Description |
| confirm_quest (default) | 0 | question mark |
| confirm_exclam | 1 | exclamation mark |
| confirm_stop | 2 | stop sign |
| confirm_info | 3 | information icon |
| confirm_none | 4 | no icon |
|
button | (optional) specifies one of the following buttons.
|
| Mnemonic |
Value |
Description |
| confirm_yesno (default) | 0 | yes no |
| confirm_yesnocancel | 1 | yes no cancel |
| confirm_okonly | 2 | ok |
| confirm_okcancel | 3 | ok cancel |
| confirm_retrycancel | 4 | retry |
| confirm_abortretryignore | 5 | abort retry ignore |
Example
{
char title, msg;
int start,icon,button;
msg = "hello";
title = "msg from the heart";
start = confirm_ok;
icon = confirm_info;
button = confirm_okonly;
confirm(title,msg,start,icon,button);
}
displays a confirmation box with an OK button and an Information icon.