FormBegin()

NAME

FormBegin - display a classic formular.

PROTOTYPAGE

void FormBegin(OBJECT *tree, MFDB *bckgrnd);

PARAMETERS

tree:

object tree address of the formular.

bckgrnd:

a pointer to a valid MFDB structure or NULL.

DESCRIPTION

This function creates and displys a classic formular, i.e. a preemptive formular blocking the AES events (not displayed in a window). The formular is centered at screen (by calling the GrectCenter() function). If a NULL value is given to parameter bckgrnd, the screen area hidden by the formular is not saved in memory. A simple WM_REDRAW will be sent when the formular will be closed (FormEnd()). This mode can be used when the formular hides the desktop or windows. If a valid parameter is given to bckgrnd, the screen area hidden by the formular will stored in this buffer. This mode should be used when the formular hides another classic formulars.

Correct call of FormBegin():

     	{
     		MFDB mem;
     		FormBegin( tree, &mem);
     	}
     	{
     		FormBegin( tree, NULL);
     	}

SEE ALSO

FormDo(), FormEnd(), GrectCenter().