wguispy.gml

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

.section Start Spying
.*
.np
Message logging begins when you select a window to monitor. &spy
monitors the selected window for the messages specified. You can start
spying by selecting one window to spy on, or choosing to spy on all
windows.
.begstep To spy on all windows:
.step Choose All Windows
.ix '&spy' 'All Windows'
.ix 'All Windows'
from the Spy menu.
.result
&spy begins immediately monitoring all windows for the specified
messages. The caption bar specifies that you are monitoring all
windows.
.endstep
.begnote
.note Note:
You can use the All Windows menu item at any time, not just to start
spying.
If you begin spying by choosing one window, then want to monitor all
windows, choose All Windows from the Spy menu.
.endnote
.begstep To spy on one window:
.step Choose Select Window
.ix '&spy' 'Select Window'
.ix 'Select Window'
from the Spy menu.
.result
This minimizes the &spy window and opens the Select Window dialog
which prompts you to choose a window to monitor.
.figure *depth='2.46' *scale=100 *file='SPY8' The Select Window dialog displays information for the window on which the cursor rests.
.step Position the cursor on the window you want to monitor.
.result
As you move the cursor across the screen, the window on which the
cursor is positioned has a highlighted border and information about
the selected window appears in the dialog box.
.step Click on the window you want to monitor.
.result
Once you select a window by clicking on it, the other windows are not
selected as you move over them with the cursor. However, you can
select a window by clicking on it. This de-selects the previously
selected window and enters information about the new window in the
dialog box.
.begnote
.note Note:
You can select only one window at a time using the Select Window
dialog box.
.endnote
.step Click on OK
to save this window selection.
.result
This closes the Select Window dialog and returns you to the &spy
window. The caption bar indicates the window you are monitoring.
.endstep
.*
.section Spying on More Windows
.*
.np
Once you have started spying you can select additional windows to
monitor, unless you chose All Windows to start the spy process. You
select additional windows in the same way you select one window.
.ix 'Add Window'
.begstep
.step Choose Add Window
from the Spy menu.
.result
This minimizes the &spy window and opens the Select Window dialog.
.step Position the cursor on the window you want to monitor.
.result
Information about the currently selected window appears in the dialog.
.step Click on the window you want to monitor.
.begnote
.note Note:
You can select only one window at a time using the Select Window
dialog box.
.endnote
.step Click on OK
to save this window selection.
.result
This closes the Select Window dialog and opens the &spy window. The
window heading specifies that you are monitoring multiple windows.
.endstep
.*
.section Stop Spying
.*
.np
.ix 'Done Spying'
Choose Done Spying from the Spy menu to stop spying on the selected
windows. When you choose this item, &spy does not retain the list of
windows selected for spying.
.*
.section Pause Spying
.*
.ix 'Stop Spying Temporarily'
.np
Choose Stop Spying Temporarily from the Spy menu to pause message
logging. When you choose this item, &spy retains the list of windows
selected for spying.
.np
The Stop Spying Temporarily menu item changes to Continue Spying when
the pause is active. Choose Continue Spying from the Spy menu to start
spying again. This starts spying and changes the menu item back to
Stop Spying Temporarily.
.*
.endlevel
.*
.section &msg_info
.*
.np
Double clicking on a message in the message list reveals a Message
Information dialog box which contains additional information about the
selected message. This dialog displays the message, the number of
times it has been issued, and the window that received the selected
instance of the message.
.figure *depth='3.62' *scale=100 *file='SPY9' The Message Information dialog box displays additional information about the selected message.
.ix 'Message Information dialog'
.ix '&spy' 'Message Information dialog'
.np
From the Message Information dialog you can perform the following
actions:
.begbull $compact
.bull
Reset the usage count
.bull
Display Windows help for the message.
.bull
Change the monitoring state for the message.
.bull
Highlight the window that received the message.
.bull
Display information about the window that received the message.
.endbull
.*
.beglevel
.*
.section Resetting the Usage Count
.*
.np
You can reset the usage count for the message to zero by pressing
the Reset Count button on the Message Information dialog.  The usage
count will also be automatically reset to zero when you start spying
or clear the message list.
.*
.section Displaying Help for the Message
.*
.np
You can get more information about most messages, such as the
meaning of their parameters, by the Help for Message
button on the Message Information dialog.  This starts the
Windows help facility to display the information. Help is not
available for all messages.
.*
.section Changing the Monitoring State of the Message
.*
.np
The watch and stop on check boxes in the Message Information dialog
indicate if the message appears in the messages to watch or messages
to stop on lists.  You can add the message to either of these lists
by checking the appropriate check box or remove it by removing the
check.
.*
.section Highlighting the Receiving Window
.*
.np
If the window that received this message has not been destroyed you
can highlight it by selecting the Highlight Window button.
This changes the border &colour of the window so it is easy to locate.
.*
.section Displaying Information about the Receiving Window
.*
.np
If the window that received this message has not been destroyed you
can get additional information about it by selecting the Show Information
button. This opens a Window Information dialog that displays
information such as the window's class, style, size and position. For
more information on the Window Information dialog see the section
entitled :HDREF refid='viewinf'..
.*
.endlevel
.*
.im wguilog &spy
.*
.section *refid=viewinf Viewing Window Information
.*
.np
.ix 'window information' 'viewing in &spy'
.ix '&spy' 'view window information'
In &spy you can view different window information using items in the
Spy menu. You can view:
.begbull $compact
.bull
information about a specific window
.bull
a list of all windows open on your desktop
.endbull
.*
.beglevel
.*
.section *refid=wininfo &win_info
.*
.np
.ix 'Peek at Window'
.ix 'Window' 'Peek At in &spy'
To view information about a window:
.begstep
.step Choose Peek At Window
from the Spy menu.
.result
This minimizes the &spy window and opens the Peek At Window dialog
box.
:cmt. .figure *depth='1.xx' *file='SPY12' The Peek at Window dialog displays information about the window on which the cursor rests.
.step Position the cursor on the window you want to monitor.
.result
As you move the cursor across the screen, the window on which the
cursor is positioned has a highlighted border and information about
the selected window appears in the dialog box. The following
information is displayed:
.begpoint $break
.point Window
the handle of the window and its title, if it has one
.point Class
the name of the window class to which this window belongs
.point Parent
the handle of the window's parent if it has one
.point Size
the screen coordinates of the top right and bottom left corners of the
window, followed by the window's size
.point Window Style
the window's style bits
.point Class Style
the style bits for the window's class
.point Child ID
a numeric identifier associated with the window when it is created
(This only appears if the selected window is a child window.)
.endpoint
.step Click on the desired window to monitor.
.result
Once you select a window by clicking on it, the other windows are not
selected as you move over them with the cursor. However, you can
select a window by clicking on it. This de-selects the previously
selected window and enters information specific to the new window in
the dialog box.
.step Click on OK
to close the dialog box.
.result
This closes the Peek at Window dialog box and returns you to the
&spy window.
.endstep
.*
.section Listing All Windows
.*
.np
To view a list of all windows open on your desktop:
.begstep
.step Choose Show Selected Windows
from the Spy menu.
.ix 'Show Selected Windows'
.result
This opens the Window Selection dialog box which displays the
following:
.begbull $compact
.bull
window handles
.bull
window captions
.endbull
.figure *depth='3.20' *scale=87 *file='SPY13' The Window Selection dialog displays a list of all windows currently open on the desktop.
.np
The information appears in a hierarchical manner. Windows with a parent
are listed, indented, directly below their parent. Windows currently
being monitored by &spy are marked with an asterisk.
.step
From this dialog you can perform the following functions:
.begbull $compact
.bull
Add a window for &spy to monitor
.bull
Delete a window that &spy is monitoring
.bull
Select all windows for monitoring
.bull
View information about a window in the list
.endbull
.endstep
.*
.beglevel
.*
.section Adding a Window
.*
.np
.ix 'window' 'adding in &spy'
.ix '&spy' 'adding a window'
You can add a window for &spy to monitor in two ways:
.begstep
.step Double click on the line
for the window you want to add, or
.step Click once on the line
for the desired window to select it and then select the Add button.
.endstep
.np
The window you added is now marked with an asterisk indicating that
&spy is monitoring that window.
.np
Click on OK to close the dialog and save the updated window list.
.*
.section Deleting a Window
.*
.np
.ix 'window' 'deleting'
.ix '&spy' 'deleting a window'
To delete a window that &spy is monitoring, do one of the following:
.begstep
.step Double click on the line
for the window you want to delete, or
.step Click once on the line
for the window that you no longer want &spy to monitor and then select
the Delete button.
.endstep
.np
This removes the asterisk from beside the window handle, indicating
that &spy is no longer monitoring that window.
.np
Click on OK to close the dialog and save the updated window list.
.*
.section Monitoring All Windows
.*
.np
To instruct spy to start spying on all windows open on the desktop,
check the "Spy on all windows" check box.  Then chose the OK button
to close the dialog and accept this selection.
.*
.section Viewing Information
.*
.np
.ix 'Show Info button' 'in &spy'
.ix '&spy' 'Show Info button'
To view information about a window in the list, do the following:
.begstep
.step Click once on the line
for the window whose information you want to view.
.result
The selected line appears highlighted in the list.
.step Select the Show Info button
on the dialog.
.result
The Window Information dialog box opens. The information in this
dialog is identical to the information in the Peek at Window dialog
box. Refer to the section entitled :HDREF refid='wininfo'. for a
description of the fields in this dialog.
.step Click OK.
.result
The Window Information dialog closes and you return to the Window
Selection dialog.
.step Click OK
on the Window Selection dialog to close it.
.endstep
.*
.endlevel
.*
.endlevel
.*