IDebugDocumentTextEvents2
Note
This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
This interface is used to notify Visual Studio about changes to the source document that are supplied by the debug engine.
Syntax
IDebugDocumentTextEvents2 : IUnknown
Notes for Implementers
The DE implements this interface to support making changes to the source code. This interface is typically implemented on the same object that implements the IDebugDocument2 interface.
Notes for Callers
Visual Studio obtains this interface through a call to the Advise method. The IConnectionPoint interface is obtained from a call to the EnumConnectionPoints method. The IConnectionPointContainer interface is obtained by calling the QueryInterface method on an IDebugDocument2 interface.
Methods in Vtable Order
The following table shows the methods of IDebugDocumentTextEvents2.
| Method | Description |
|---|---|
| onDestroy | Indicates that the entire document has been destroyed. |
| onInsertText | Notifies the debug package that text has been inserted into the document. |
| onRemoveText | Notifies the debug package that text has been removed from the document. |
| onReplaceText | Notifies the debug package that text has been replaced in the document. |
| onUpdateTextAttributes | Notifies the debug package that text attributes have been updated in the document. |
| onUpdateDocumentAttributes | Notifies receiver of the event that the document attributes have been updated. |
Remarks
Only debug engines that supply their own documents would take advantage of the IDebugDocumentTextEvent2 interface. An example of this would be a scripting debug engine. In the process of interpreting scripts, new source code can be generated that is not present in any disk file and is known only to the DE.
Requirements
Header: msdbg.h
Namespace: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll