3.77 DM_TraceMessage

Mit Hilfe dieser Funktion können Trace-Meldungen von der Anwendung in das Tracefile des Dialog Managers geschrieben werden.

void DML_c DM_EXPORT DM_TraceMessage
(
  DM_string string,
  DM_Options options
)

Parameter

-> DM_string string

Dieser Parameter ist der String, der in das Tracefile geschrieben werden soll.

-> DM_Options options

Für diese Funktion sind folgende Optionen zulässig:

Option

Bedeutung

DMF_InhibitTag

Mit Hilfe dieser Option kann die Anwendung beeinflussen, ob der Dialog Manager den Zeilenanfang ("header") [UM] am Anfang einer Zeile schreibt oder nicht. Wird der Parameter auf DMF_InhibitTag gesetzt, wird der Zeilenanfang nicht gedruckt.

Wenn diese Option nicht gesetzt ist, sieht die Meldung im Tracefile wie folgt aus:

*[UM]:Angegebener String

DMF_Printf

Wird diese Option gesetzt, wird der Parameter string wie bei der C-Funktion printf interpretiert. Die entsprechenden zusätzlichen Parameter müssen hinter dem Parameter options angegeben werden. Floating-Point Formate werden hier nicht unterstützt.

DMF_LogFile

Wird diese Option gesetzt, erfolgt die Ausgabe nicht in das Tracefile, sondern in das Logfile.

Anmerkung

Die angegebenen Trace-Meldungen werden nur gedruckt, wenn der Dialog Manager mit der Trace-Option gestartet wird.

Beispiel

Ausgabe einer Meldung im Hauptprogramm, wenn die Funktion DM_Initialize FALSE als Ergebnis zurückliefert.

int DML_c DM_CALLBACK AppMain __2(

(int, argc),

(char **, argv))

{

    DM_ID dialogID;

 

    /*     * Initialisierung des Dialog Managers     */

    if (!DM_Initialize (&argc, argv, 0))

    {

        DM_TraceMessage("could not initialize",

            DMF_LogFile);

        return (1);

    }