EV_startTask Function (ROM Call 0xD6)

events.h

void EV_startTask (unsigned short StartType);

Starts a particular task in the running application.

EV_startTask sends CM_STARTTASK message to the running application. Field StartType of the event structure will be filled from StartType parameter of this function (this is the only message in which StartType field is significant). Field r (in extra field) of the event structure will be filled from the result of executing EV_getSplitRect function (with current side given to it as the parameter). How StartType will be interpreted depends on the concrete application. Usually, three types of "starting" are supported: AP_START_CURRENT, AP_START_NEW and AP_START_OPEN (these constants are defined in enum StartTypes. For example, Text and Data/Matrix editor may be started in three submodes: "Current", "Open" and "New". Under normal circumstances, you should start another task with AP_START_CURRENT.


Uses: EV_getSplitRect, EV_sendEvent, EV_appSide
Used by: EV_centralDispatcher, EV_startApp, MO_digestOptions