Component framework

Type	Object
Summary	General GUI framework
Description	This is the main component one will use to create a modern GUI application. In general, any GUI application will use one FRAMEWORK object to handle its main window. The FRAMEWORK object handle the general layout and the following items: menubar, taskbar, part of the help menu, document area (up to 5, status area. Each document area may be multi-documents with a notebook. The framework handle various core function such as the quit/mayquit protocol and the focus notification.

void newdocument (void *data)		void about ()
void newdocument (void *data, int noarea)		void area1 (FRAMEWORK_INFO&info)
		void area2 (FRAMEWORK_INFO&info)
		void area3 (FRAMEWORK_INFO&info)
		void area4 (FRAMEWORK_INFO&info)
		void area5 (FRAMEWORK_INFO&info)
		void document (int noarea, FRAMEWORK_INFO&info)
		void ending (bool &do_not_end)
		void helpindex ()
		void layout ()
		void menubar ()
		void menudo (int id, FRAMEWORK_INFOS[]infos, FRAMEWORK_INFO *[]focus)
		void message ()
		void messages ()
		void nodocument (int area, bool &end)
		void status (PRIVATE_MESSAGE&ending)
		void taskbar ()
		int taskdo (int id, int allo)
		void taskdo (int id, FRAMEWORK_INFOS[]infos, FRAMEWORK_INFO *[]focus)

Examples

sample / FRAMEWORK / framework inside framework
sample / FRAMEWORK / quit-without-save
sample / FRAMEWORK / restarting documents
sample / FRAMEWORK / using layout

Prototypes

framework (const char *title, PRIVATE_MESSAGE &msg)

framework (const char *title)

Main constructor, normally used for the first FRAMEWORK of a program

framework (const char *title, FRAMEWORK_INFO &info)

Methods

void newdocument (void *data): Request the edition of a new document
void newdocument (void *data, int noarea): Request the edition of a new document in one area

Functags

void about () Optional

Must present information about this program

void area1 (FRAMEWORK_INFO&info) Optional

Define documents for area one

void area2 (FRAMEWORK_INFO&info) Optional

Define document for area two

void area3 (FRAMEWORK_INFO&info) Optional

Define documents for area three

void area4 (FRAMEWORK_INFO&info) Optional

Define documents for area four

void area5 (FRAMEWORK_INFO&info) Optional

Define documents for area five

void document (int noarea, FRAMEWORK_INFO&info) Optional

Default document handling functag

document is called if the areaN tag is not defined

void ending (bool &do_not_end) Optional

Called when the application is ready/willing to end

When every document accepted to end, but the framework ask all document to end. this functags is called. This is generally used to collect various information about the current documents and potentially as a last chance to abort the end.

void helpindex () Optional

void layout () Optional

void menubar () Optional

void menudo (int id, FRAMEWORK_INFOS[]infos, FRAMEWORK_INFO *[]focus) Optional

This is called when a menu option is selected

Not much

void message () Optional

Called when a message is received

void messages () Optional

void nodocument (int area, bool &end) Optional

Called when there is no more document displayed

The application may use this to create setup a default document.

void status (PRIVATE_MESSAGE&ending) Optional

Manage the status bar

The application can define any status bar. In fact, the application sets a dialog with whatever content. In general, PRIVATE_MESSAGE are used to signal the dialog so it updates its content.

void taskbar () Optional

int taskdo (int id, int allo) Optional