SYSmessageEx

Top  Previous  Next

Spend an announcement, if necessary as a dialogue.

SYSmessageEx serves above all the easy treatment of memory-resident announcement texts. In contrast to SYSmessage the announcement is not returned and a dialogue box is given if necessary instead of the assembly-line text announcement. The announcement number may not fall out higher than 9999.

Parametre

root (PROOT) [IN]

Act on the open data bank.

module (const char *) [IN]

This is the name of the procedure under which the announcement is filed in the file MELDUNG.DAT.

num (int) [IN]

This is the running number of the announcement within a module.

art (long int) [IN]

Default of the configuration. A basic configuration can be chosen. However, it can be also given which qualities the announcement of the announcements should have (see Flags).

titel (const char *) [IN]

Here a title string can be handed over if necessary for the announcement of the announcement as a dialogue box. If ZERO is given here, a standard title is chosen.

... [IN]

When other parametres are able like with printf the values for %d, %s... follow.

Result

---

Flags

The following Flags can be bragged also combined, with art:

MSG_ART_FEHLER 3

Standardflags for error message use.

MSG_ART_WARNUNG 2

Standardflags for warning announcements use.

MSG_ART_HINT 1

Standardflags for tips use.

MSG_ART_BEEP 4

A short Beep spend.

MSG_ART_PAUSE_KURZ 8

By the announcement take a short break (1s).

MSG_ART_PAUSE_LANG 16

By the announcement take a long break (5s).

MSG_ART_PAUSE_RETURN 24

By the announcement wait for Return key.

MSG_ART_POPUP_OUTPUT 32

If the announcement is given as an assembly-line text, the issue window should be opened before.

MSG_ART_AS_POPUP 64

The announcement is shown as an announcement window. At least one OK-badge exists.

MSG_ART_AS_TEXT 128

The announcement is shown as a text in the protocol window.

MSG_ART_SET_ERRORLEVEL_MSG 256

MSG_ART_SET_ERRORLEVEL_WRN 512

MSG_ART_SET_ERRORLEVEL_ERR 768

MSG_ART_SET_ERRORLEVEL_FAT 1024

MSG_ART_FATALBEEP 2048

MSG_ART_ERRBEEP 16384

A long warning tone is given.

Declaration

#include "system.h"

 

void DLLENTRY SYSmessageEx (

PROOT root,

const char * module,

int num,

long int art,

const char * titel

...

);