[Win32forth-cvs] win32forth/src/console Console2.f,1.3,1.4

[Dirk B. <db...@us...>]

Update of /cvsroot/win32forth/win32forth/src/console
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv12709/src/console

Modified Files:
	Console2.f 
Log Message:
DexH style documention added.

Index: Console2.f
===================================================================
RCS file: /cvsroot/win32forth/win32forth/src/console/Console2.f,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** Console2.f	30 Aug 2005 14:08:15 -0000	1.3
--- Console2.f	24 Dec 2005 11:57:59 -0000	1.4
***************
*** 300,311 ****
  \                 r@ call SelectObject drop \ selects the object
  \                 r> conHndl call ReleaseDC drop
!                 ; DEPRECATED 
  
  \ : _>bold        ( -- )
  \                 OEM_FIXED_FONT set-font ;
! \ 
  \ : _>norm        ( -- )
  \                 ANSI_FIXED_FONT set-font ;
! \ 
  \ ' _>bold is >bold
  \ ' _>norm is >norm
--- 300,311 ----
  \                 r@ call SelectObject drop \ selects the object
  \                 r> conHndl call ReleaseDC drop
!                 ; DEPRECATED
  
  \ : _>bold        ( -- )
  \                 OEM_FIXED_FONT set-font ;
! \
  \ : _>norm        ( -- )
  \                 ANSI_FIXED_FONT set-font ;
! \
  \ ' _>bold is >bold
  \ ' _>norm is >norm
***************
*** 355,362 ****
                  then 3drop ;
  
! : (SetForegroundWindow) ( hwnd -- )
                  ['] SetForegroundWindow (SetWindow) ;
  
  : (SetActiveWindow) ( hWnd -- )
                  ['] SetActiveWindow (SetWindow) ;
  
--- 355,395 ----
                  then 3drop ;
  
! : (SetForegroundWindow) ( hwnd -- )     \ w32f
! \ *G The SetForegroundWindow function puts the thread that created the specified window
! \ ** into the foreground and activates the window. Keyboard input is directed to the window,
! \ ** and various visual cues are changed for the user. The system assigns a slightly higher
! \ ** priority to the thread that created the foreground window than it does to other threads. \n
! \ ** The foreground window is the window at the top of the Z order. It is the window that the
! \ ** user is working with. In a preemptive multitasking environment, you should generally let the
! \ ** user control which window is the foreground window. }n
! \ ** Windows 98, Windows 2000: The system restricts which processes can set the foreground window.
! \ ** A process can set the foreground window only if one of the following conditions is true: \n
! \ ** The process is the foreground process. \n
! \ ** The process was started by the foreground process. \n
! \ ** The process received the last input event. \n
! \ ** There is no foreground process. \n
! \ ** The foreground process is being debugged. \n
! \ ** The foreground is not locked (see LockSetForegroundWindow). \n
! \ ** The foreground lock time-out has expired (see SPI_GETFOREGROUNDLOCKTIMEOUT in SystemParametersInfo). \n
! \ ** Windows 2000: No menus are active. \n
! \ ** With this change, an application cannot force a window to the foreground while the user is
! \ ** working with another window. Instead, SetForegroundWindow will activate the window (see SetActiveWindow)
! \ ** and call the FlashWindowEx function to notify the user. For more information, see Foreground and
! \ ** Background Windows. \n
! \ ** A process that can set the foreground window can enable another process to set the foreground window by
! \ ** calling the AllowSetForegroundWindow function. The process specified by dwProcessId loses the ability to
! \ ** set the foreground window the next time the user generates input, unless the input is directed at that
! \ ** process, or the next time a process calls AllowSetForegroundWindow, unless that process is specified. \n
! \ ** The foreground process can disable calls to SetForegroundWindow by calling the LockSetForegroundWindow function.
                  ['] SetForegroundWindow (SetWindow) ;
  
  : (SetActiveWindow) ( hWnd -- )
+ \ *G The SetActiveWindow function activates a window. The window must be attached to the calling thread's message queue. \n
+ \ ** The SetActiveWindow function activates a window, but not if the application is in the background. The window will be
+ \ ** brought into the foreground (top of Z order) if its application is in the foreground when the system activates the window. \n
+ \ ** If the window identified by the hWnd parameter was created by the calling thread, the active window status of the calling
+ \ ** thread is set to hWnd. Otherwise, the active window status of the calling thread is set to NULL. \n
+ \ ** By using the AttachThreadInput function, a thread can attach its input processing to another thread.
+ \ ** This allows a thread to call SetActiveWindow to activate a window attached to another thread's message queue.
                  ['] SetActiveWindow (SetWindow) ;