guide.doc

开放源码的编译器open watcom 1.6.0版的源代码

GUI_FONT_CHANGED
	The font for the window has just been changed.  Either the user
	used a system menu item to do this, or GUISetFontInfo was called.

GUI_PAINT 
	The GUI library is requesting the window to paint the specified
	are, if there is anything to paint there.
	Macro : GUI_GET_ROWS

GUI_KEYDOWN
	A key is pressed down.
	Include guikey.h only if interested in GUI_KEYDOWN and/or GUI_KEYUP.
	Macro : GUI_GET_KEY or GUI_GET_KEY_STATE (both defined in guikey.h)
	If just the key name is needed, GUI_GET_KEY will do.  If you also
	need to know the shift state, use GUI_GET_KEY_STATE.

GUI_KEYUP
	A key is released.
	Include guikey.h only if interested in GUI_KEYDOWN and/or GUI_KEYUP.
	Macro : GUI_GET_KEY or GUI_GET_KEY_STATE (defined in guikey.h)
	If just the key name is needed, GUI_GET_KEY will do.  If you also
	need to know the shift state, use GUI_GET_KEY_STATE.

GUI_KEY_CONTROL
	A key message is sent to a control.  Only one GUI_KEY_CONTROL
	message will be sent to represent the press and release of a key.
	Macro : GUI_GET_KEY_CONTROL or GUI_GET_KEY_STATE_CONTROL (defined in
		guikey.h)

GUI_SCROLL_UP 
	The user has clicked the up arrow on the vertical scroll bar with
	the mouse.

GUI_SCROLL_PAGE_UP
	The user has clicked above the scroll thumb on the vertical scroll
	bar with the mouse.

GUI_SCROLL_TOP
	The user has used the mouse to drag the scroll thumb to the top of
	the vertical scroll bar.  

GUI_SCROLL_DOWN 
	The user has clicked the down arrow on the vertical scroll bar with
	the mouse.

GUI_SCROLL_PAGE_DOWN
	The user has clicked below the scroll thumb on the vertical scroll
	bar with the mouse.

GUI_SCROLL_BOTTOM
	The user has used the mouse to drag the scroll thumb to the bottom of
	the vertcial scroll bar;

GUI_SCROLL_VERTICAL 
 	The use has used the mouse to drag the scroll thumb to a new position
	on the vertical scroll bar.
 	Macro : GUI_GET_SCROLL

GUI_SCROLL_LEFT 
	The user has clicked the left arrow on the horizontal scroll bar with
	the mouse.

GUI_SCROLL_PAGE_LEFT
	The user has used the mouse to click to the left of the scroll
	thumb on the horizontal scroll bar.

GUI_SCROLL_FULL_LEFT
	The user has used the mouse to drag the scroll thumb to the very
	left of the horizontal scroll bar.

GUI_SCROLL_RIGHT 
	The user has clicked the right arrow on the horizontal scroll bar with
	the mouse.

GUI_SCROLL_PAGE_RIGHT
	The user has used the mouse to click to the right of the scroll
	thumb on the horizontal scroll bar.

GUI_SCROLL_FULL_RIGHT
	The user has used the mouse to drag the scroll thumb to the very
	right if the horizontal scroll bar.

GUI_SCROLL_HORIZONTAL 
 	The use has used the mouse to drag the scroll thumb to a new position
	on the horizontal scroll bar.
 	Macro : GUI_GET_SCROLL

GUI_CLICKED
	A menu item has been triggered by mouse press or keyboard interaction.
	Macro : GUI_GETID

GUI_DCLICKED
	A control was double clicked.
	Macro : GUI_GETID

GUI_LBUTTONDOWN
	The left mouse button has been pressed.
 	Macro : GUI_GET_POINT

GUI_LBUTTONUP
	The left mouse button is released.
 	Macro : GUI_GET_POINT

GUI_LBUTTONDBLCLK
	The left mouse button is double clicked.
	Note : double click sequence is press-release-dblclk-release and
	       then the sequence is repeated.
 	Macro : GUI_GET_POINT

GUI_RBUTTONDOWN
	The right mouse button is double pressed.
 	Macro : GUI_GET_POINT

GUI_RBUTTONUP
	The right mouse button is double released.
 	Macro : GUI_GET_POINT

GUI_RBUTTONDBLCLK
	The right mouse button is double clicked.
 	Macro : GUI_GET_POINT
	Note : double click sequence is press-release-dblclk-release and
	       then the sequence is repeated.

GUI_MOUSEMOVE
	The mouse is moved.
 	Macro : GUI_GET_POINT

GUI_TOOLBAR_DESTROYED
	The tool bar has been destroyed.

GUI_TOOLBAR_FIXED
	The tool bar was floating but is has now become fixed.  This can
	happen through user interaction only.

GUI_TOOLBAR_FLOATING
	The tool bar was fixed but is has now become floating.  This can
	happen through user interaction only.

GUI_CLOSE
	This message will be sent to the window before the GUI_DESTROY message
	is sent if the window has the choice of closing or not.  If TRUE
	is returned from the message, the window will be destroyed.  If
	FALSE is returned, the window will not be destroyed.

GUI_DESTROY
	The window is being destroyed.

GUI_HSCROLL_NOTIFY
	The window has been scrolled horizontally.  Only sent when no other
	scroll message was sent (ie. library handling scroll events).

GUI_VSCROLL_NOTIFY
	The window has been scrolled vertically.  Only sent when no other
	scroll message was sent (ie. library handling scroll events).

GUI_CONTROL_NOT_ACTIVE
	Sent to a dialog box or window when the control indicated has just
	lost input focus.  This message will only be sent to some controls
	(namely GUI_EDIT, GUI_LISTBOX, GUI_COMBOBOX, and GUI_EDIT_COMBOBOX ).
	Use the GUI_GETID macro to extract the id of the control that has
	just lost focus.

GUI_CONTROL_CLICKED
	A control item has been triggered by mouse press or keyboard interaction.
	Macro : GUI_GETID

Macros
------

GUI_GET_POINT :

#define GUI_GET_POINT( param, point ) ( point = *( gui_point * )param )

	Use when receiving the following messages :

	GUI_MOUSEMOVE
	GUI_LBUTTONUDOWN
	GUI_LBUTTONUP
	GUI_LBUTTONDBLCLK
	GUI_RBUTTONUDOWN
	GUI_RBUTTONUP
	GUI_RBUTTONDBLCLK

        Takes 1 parameter of type gui_point, which will be set to the
	location of the mouse action.


GUI_GET_ROWS :

#define GUI_GET_ROWS( param, gui_start, gui_num ) {                          \
                                gui_start = (( gui_row_num * )param)->start; \
                                gui_num =   (( gui_row_num * )param)->num;   \
		                                   }
	Use when receiving the following message :

	GUI_PAINT

	Takes 2 parameters of type gui_ord ( gui_start ) and int ( gui_num ).
	gui_start is the row to start painting at and gui_num is the
	number of rows to paint.  The first row is 0.

GUI_GETID :

#define GUI_GETID( param, id ) ( id = *( unsigned * )param )

	Use when receiving the following messages :

	GUI_CONTROL_NOT_ACTIVE
	GUI_CLICKED
	GUI_CONTROL_CLICKED
	GUI_CONTROL_DCLICKED

	Takes 1 parameter of type unsigned which will be set to the menu
	or control id.  GUI_CLICKED can be to a menu.  GUI_CONTROL_CLICKED
	and GUI_CONTROL_DCLICKED can be sent for a control.  A
	GUI_CONTROL_NOT_ACTIVE message can be sent in a dialog box or window,
	meaning that the control indicated has just lost input focus.  This
	message will only be sent to some controls (namely GUI_EDIT,
	GUI_LISTBOX, GUI_COMBOBOX, and GUI_EDIT_COMBOBOX ).

GUI_GET_SIZE :

#define GUI_GET_SIZE( param, size ) { size.x = (( gui_coord * )param)->x; \
                                      size.y = (( gui_coord * )param)->y; }

	Use when receiving the following message :

	GUI_RESIZE

	Takes 1 parameter of type gui_coord which will be set to contain
	the new width and height of the window.

GUI_GET_SCROLL :

#define GUI_GET_SCROLL( param, scroll ) ( scroll = *( int * )param )

	Use when receiving the following messages :

	GUI_SCROLL_VERTICAL
	GUI_SCROLL_HORIZONTAL

	Takes 1 parameter of type int which will be set to contain the
	amount scrolled horizontally or vertically (by dragging scroll
	thumb).

GUI_GET_KEY :

#define GUI_GET_KEY( param, inkey ) ( inkey = (( gui_key_state *)param)->key )

	Use when receiving the following messages :

	GUI_KEY_DOWN
	GUI_KEY_UP

	Takes one parameter, of type gui_key, which will be set to be
	the key pressed or released.


GUI_GET_KEY_STATE :

#define GUI_GET_KEY_STATE( param, inkey, state ) { 		\
		inkey = (( gui_key_state *)param)->key;		\
		state = (( gui_key_state *)param)->state;	\
						}		\

	Use when receiving the following messages :

	GUI_KEY_DOWN
	GUI_KEY_UP

	Takes two parameters, of type gui_key and gui_keystate which will
	be set to be the key pressed or release and they key state when
	that key was pressed or released.

GUI_GET_KEY_CONTROL :

#define GUI_GET_KEY_CONTROL( param, id, inkey )	{		\
	id = ((gui_key_control *)param)->id;			\
	inkey = (( gui_key_control *)param)->key_state.key;	\
				   		}		\

	Use when receiving the following messages :

	GUI_KEY_CONTROL

	Takes two parameters, of type unsigned and gui_key, which will be
	set to be the id of the control receiving the keyboard input and
	the key pressed and released.

GUI_GET_KEY_STATE_CONTROL :

#define GUI_GET_KEY_STATE_CONTROL( param, id, inkey, state ){	\
	id = ((gui_key_control *)param)->id;			\
	inkey = (( gui_key_control *)param)->key_state.key;	\
	state = (( gui_key_control *)param)->key_state.state;	\
				   	}			\

	Use when receiving the following messages :

	GUI_KEY_CONTROL

	Takes three parameters, of type unsigned, gui_key and gui_keystate
	which will be set to be the id of the control receiving the keyboard
	input, the key pressed and release and they key state when
	that key was pressed or released, respectively.