IDebugDocumentTextEvents2

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. 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

See also