MessageAreaConfigureHandler

  set_message_area_configure_handler( MessageAreaConfigureHandler my_handler )

Synopsis

#include "silver.h"

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

Parameters

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

typedef void SILVERC_API

  (SDCCALL *MessageAreaConfigureHandler)( int lines, int color );

int lines;  // The number of lines requested for a message area

int color;  // The color index of the background color of the message area

Return Value

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

Remarks

It is essential for SilverEngine applications to provide a handler for the MessageAreaConfigureHandler prior to calling message_area_configure. Such a handler will have to create a message area and initialize it, and when the number of lines is 0, it will need to close the window.

See Also

set_message_area_write_handler, message_area_configure, message_area_write

Example

See message_area_configure for an example that uses a message area.