wguidspy.gml

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

:set symbol="msg_list" value="event list"
:set symbol="mark_menu" value="output"
:set symbol="appname" value="&dde"
.*
.chap &dde
.*
.if &e'&dohelp eq 0 .do begin
.section Introduction
.do end
.*
.np
.ix '&dde'
&dde is a debugging tool that allows you to watch all DDE (Dynamic
Data Exchange) activity occurring in the system. &dde also allows you
to monitor DDEML errors and registration of various DDE objects, such
as strings, conversations, links, and servers. DDE is one way for
different applications running under Windows to communicate with each
other.
.np
By watching the communications between applications, you can determine
if the information being sent is correct. If it does not seem correct
you can locate the cause of the error.
.*
.section Using &dde
.*
.np
This section discusses the following topics:
.begbull $compact
.bull
Starting &dde
.bull
Quitting &dde
.bull
The &dde Menu Bar
.bull
The &dde Toolbar
.endbull
.*
.beglevel
.*
.section Starting &dde
.*
.np
.ix '&dde' 'start'
.ix 'start' '&dde'
To start &dde, double click on the &dde icon. This opens the &dde
window. When you start the application, the &company &dde window is
always empty. This window displays the menu bar and a toolbar.
.keep 19
.figure *depth='2.56' *scale=71 *file='DDE1' The &company &dde window contains the event list, menu bar, and toolbar.
.*
.section Quitting &dde
.*
.np
.ix 'leave' '&dde'
.ix '&dde' 'leave'
To exit &dde, choose Exit from the File menu of the &company &dde
window.
.*
.section The &dde Menu Bar
.*
.np
.ix 'Menu bar' '&dde'
.ix '&dde' 'Menu bar'
The menu bar consists of the following six menus:
.begpoint
.point File
Save to a file, start and pause logging, and configure the session
.point Output
Work with the event list and control its output behaviour
.point Monitor
Select the information you want &dde to write to the event list
.point Track
Display windows summarizing information for DDE objects tracked by &dde
.point Aliases
Replace numeric values with meaningful text
.point Help
Access on-line help information
.endpoint
.figure *depth='0.72' *scale=71 *file='DDE1A' The &company &dde menu bar.
.*
.section The &dde Toolbar
.*
.np
.ix 'Show Toolbar' 'in &dde'
.ix '&dde' 'Show Toolbar'
In the &company &dde window, the toolbar appears below the menu bar
when the Show Toolbar item in the File menu is checked. To disable
this feature, choose the item again from the File menu and the
Toolbar disappears.
The following explains the function each toolbar button performs,
as well as the equivalent menu item.
.begnote
.note TRACK STRINGS
Display or hide the strings tracking window.  This window displays a
list of all strings currently registered with the operating system.
This button is equivalent to the Strings item in the Track menu.
.note TRACK CONVERSATIONS
Display or hide the conversations tracking window. This window
displays a list of all conversations currently active in the system.
This button is equivalent to the Conversations item in the Track menu.
.note TRACK LINKS
Display or hide the links tracking window.  This window displays
a list of all links currently active in the system. This
button is equivalent to the Links item in the Track menu.
.note TRACK SERVERS
Display or hide the servers tracking window.  This window displays
a list of all servers currently registered with the operating system.
This button is equivalent to the Servers item in the Track menu.
.note LOG
Start Logging. This button is equivalent to the Log to
File item in the File menu.
.note MARK
Record your own comments in the event list. This button is
equivalent to the Mark item in the Output menu.
.note CLEAR
Clear the event list.  This button is equivalent to the Clear item
in the Output menu.
.note ADD HWND ALIAS
Replace window handle values with text. This is equivalent to the
Add Hwnd Alias item in the Alias menu.
.note ADD TASK ALIAS
Replace task id values with text. This is equivalent to the
Add Task Alias item in the Alias menu.
.note ADD CONVERSATION ALIAS
Replace conversation id values with text. This is equivalent to the
Add Conversation Alias item in the Alias menu.
.endnote
.figure *depth='0.72' *scale=71 *file='DDE1A' The &company &dde toolbar.
.*
.endlevel
.*
.section The &dde Event List
.*
.np
.ix 'event list' 'in &dde'
.ix '&dde' 'event list'
Opening &dde reveals an empty window. This is the event list where
&dde logs the information you define in the Monitor menu. Some
examples of events are strings being created or deleted and
conversations and links being established or terminated.
.keep 19
.figure *depth='2.56' *scale=71 *file='DDE2' Once you start spying, the event list displays the information selected for monitoring.
.np
This section describes the tasks you can perform in relation to the
event list.
.*
.beglevel
.*
.section &dde: Setting the Font
.*
.np
.ix 'fonts' 'set in &dde'
.ix '&dde' 'set fonts'
The Font item in the File menu allows you to set the font, style, and
size for the text in the &dde window. Choosing this item opens the Font
dialog box. Select the desired font details and click on OK to
close the dialog and apply the fonts.
.*
.section &dde: Saving the Event List to a File
.*
.np
.ix 'Save' 'in &dde'
.ix '&dde' 'save'
The Save items in the File menu allow you to save the contents of the
event list to a text file. Saving information to a file enables you to
print the output later or annotate the text file on-line.
.np
Choose Save from the File menu in the &company &dde window to save
the event list information into the current working directory. A
message box appears indicating the path to which &dde saved the file.
.np
.ix 'Save As' 'in &dde'
Choose Save As from the File menu to specify the file to which you
want to save the event list information. This opens a Save As dialog
box where you select the desired file. Click on OK when completed. A
message box appears indicating the path to which &dde saved the file.
.*
.section &dde: Clearing the Event List
.*
.np
.ix 'event list' 'clear in &dde'
.ix '&dde' 'clear event list'
.ix 'Clear option'
Choose Clear from the File menu to delete all information from the
current event list.
.*
.section &dde: Marking the Event List
.*
:include file='wguimark.gml'
.*
.section &dde: Pausing the Event List Output
.*
.np
.ix 'Output to Screen'
.ix 'Screen' 'output to'
.ix '&dde' 'output to screen'
The Output to Screen item in the Output menu allows you to temporarily
stop writing information to the event list. When this menu item is
unchecked output will not be written to the event list. Although &dde
stops writing information to the event list, it still writes it to the
log file if you are currently creating a log file. When &dde is not
writing information to the event list applications will run sightly
faster so when you are not interested in viewing the event list you
may want to stop writing to it.
.begnote
.note Note:
If you mark the event list while the Output to Screen feature is
deactivated, the text you enter does not appear in the event list.
.endnote
.*
.section &dde: Automatic Scrolling
.*
.np
.ix 'Auto Scroll'
.ix 'Scroll' 'automatic'
.ix '&dde' 'automatic scrolling'
As &dde writes new information to the event list, the information is
added to the bottom of the list. Checking the Auto Scroll item in
the Output menu tells &dde to automatically scroll the information
in the event list so that the most recent information written to
the event list always appears on the screen.
.np
When the Auto Scroll menu item not checked you must use the scroll
bar to scroll down and view any new information that is added to
the event list.
.*
.endlevel
.*
.section Selecting Information to Monitor
.*
.np
.ix '&dde' 'Monitor menu'
.ix 'Monitor menu' 'in &dde'
The monitor menu contains items that let you specify the types
of DDE events that &dde will report on by recording them in the
event list. Limiting the amount of information logged makes reading
the event list more efficient.
.np
When an item appears in the menu with a checkmark, &dde reports
on that type of activity. The following describes various types of
activity &dde can monitor.
.begpoint $break
.point Posted Messages
When the Posted Messages item is checked, &dde makes an entry in
the event list whenever a DDE message that has been selected using the
Message Filter dialog is posted to an application's message queue.
.point Sent Messages
When the Sent Messages item is checked, &dde makes an entry in the
event list whenever a DDE message that has been selected using the
Message Filter dialog is sent to an application.
.point String Handle Data
DDE applications use strings to communicate with other applications.
These strings are registered with the operating system by the
applications using them. When done with the strings, the applications
tell the operating system they are done and the system destroys the
strings. &dde reports on all string operations that occur within the
system when the String Handle Data menu item is checked.
.point Callbacks
Callbacks are special functions called by the operating system to
process DDE messages. When the Callback item is checked &dde makes an
entry in the event list each time the operating system calls a DDE
Callback for a transaction type that has been selected using the
Callback Filter dialog.
.point Errors
A DDE error usually indicates that a DDE operation has failed. When
the Errors item is checked, &dde reports all DDE errors that occur
within the system.
.point Conversations