MessageAreaWriteHandler

  set_message_area_write_handler( MessageAreaWriteHandler my_handler )

Synopsis

#include "silver.h"

The set_message_area_write_handler function defines a function that is notified when SilverEngine or SilverPlus wish to write to the message area.

Parameters

my_handler is a SilverC API function pointer to a MessageAreaWriteHandler that is called whenever it is time to write to the message area. It is declared as follows, and is only relevant in SilverPlus and SilverEngine development models.

typedef void SILVERC_API

  (SDCCALL *MessageAreaWriteHandler)(char *text, int line, int color);

char *text; // A null-terminated C-type message string

int  line;  // The line upon which to write 'text'

int  color; // The foreground color index that will render 'text'

Return Value

set_message_area_write_handler returns  a pointer to the active message-area write handler. Your handler should not return any value.

Remarks

It is essential for SilverEngine applications to provide a handler for the MessageAreaWriteHandler prior to calling message_area_write. Such a handler will display the message in the message area.

See Also

set_message_area_configure_handler, Callback Routine Types