MO_sendQuit Function (ROM Call 0xDF)

events.h

void MO_sendQuit (short TaskID, short Side);

Quits an application on given side.

MO_sendQuit quits an application on side Side (0=left/top, 1 = right/bottom). This is what pressing of the QUIT key does. More precise, if Side is equal to the current side, the side will receive CM_UNFOCUS and CM_DEACTIVATE messages. After this, the application will receive CM_ENDTASK message. Finally, the application on side Side will be set to CM_NULL. If the application on side Side is already CM_NULL, nothing will be performed.

Note: If you don't understand what "quitting" means, try MO_sendQuit(AP_CURRENT, 0) from your program to "quit" the "Home screen" application. You will notice that the menu will dissappear. Later, executing commands will not show results in the home screen, because "repainting" of the "Home screen" window will be suspended (the application is set to CM_NULL).


Uses: EV_sendEventSide, EV_appA, EV_appB, EV_appSide
Used by: EV_defaultHandler, MO_digestOptions, EV_quit