SYSmessageStringFromFile

Gets an announcement text from the announcement file.

This routine is almost identical with SYSmessageString, in addition, still the file from which the texts are got is given here nevertheless. As a macro it is defined for this MAKE_MENUE_STRING. You take the remaining information please SYSmessageString.

Parametre

datei (char *) [IN]

The texts are read from the file with this name. The file name must contain path and extension.

msg (char *) [IN]

The sign chain which specifies the group of the announcements. This text can be freely chosen, however, should agree with the name of the function, so that no overlappings happen.

nummer (int) [IN]

Number of the announcement within the group. There is only in each case an announcement with every combination msg/number.

doDefault (int) [IN]

If this parametre TRUE contains, an announcement is also generated if no entry is for this announcement number in of the file. If the parametre FALSE contains, in this case ZERO is delivered as a return value.

Result

(char *) [OUT]

Pointer on a text with the announcement from the file datei. The text has been generated with Malloc and must be decontaminated with Free again.

Declaration

#include "basic.h"

char *DLLENTRY SYSmessageStringFromFile (

char * datei

char * msg,

int nummer,

int doDefault,

);

Other declarations

The following macro delivers the definition text of a menu

#define MAKE_MENUE_STRING (file, modul, nummer) \

SYSmessageStringFromFile (file, modul, nummer, TRUE)