
------------------------------------------------------------------------------
2.4 Activate window. <Main>
------------------------------------------------------------------------------
[Name]
win_activate
[Syntax]
#include <crt.h>
int win_activate( whandle handle ) ;
[Arguments]
handle window handle for the window to be activated
[Return]
Returns zero if successful. When failed, returns "-1" and sets
following error code to the global variable "errno".
EW_NOTOPEN specified window not exist
[Description]
Select one of the open windows on the screen for keyboard input.
After this function is called, succeeding input from MDI keyboard is
valid only while the window is selected for display by win_select().
The window selected by this function is also selected as display
window.
This function changes the overlapping order of the windows so that
the selected window comes on top of other windows.
Whole screen is redrawn by this function call.