This documentation is archived and is not being maintained.

DestructiveInsert Method

Visual Studio .NET 2003

Inserts text, overwriting the existing text.

[Visual Basic .NET]
Public Sub DestructiveInsert( _
   ByVal Text As String _
) 
[Visual Basic 6]
Sub DestructiveInsert( _
   ByVal Text As String _
) 
[C++]
HRESULT __stdcall DestructiveInsert(
   BSTR Text
);
[C#]
public void DestructiveInsert(
   string Text
);
[JScript .NET]
public function DestructiveInsert(
   Text : String
)

Parameters

Text
Required. Represents the text to insert.

Remarks

Newline characters cause the text selection's active end to move to the beginning of the next line, possibly inserting indentation depending on the language used in the text document.

Example

Public objSel As TextSelection = DTE.ActiveDocument.Selection

Sub DestructiveInsertExample()
   ' Before running this example, open a text document.
   ' Perform operations on the text.
   objSel.StartOfDocument(False)
   Position(vsStartOfLineOptions.vsStartOfLineOptionsFirstColumn, 4)
   objSel.Copy()
   Position(vsStartOfLineOptions.vsStartOfLineOptionsFirstText, 4)
   objSel.Cut()
   Position(vsStartOfLineOptions.vsStartOfLineOptionsFirstText, 4)
   objSel.Delete()
   Position(vsStartOfLineOptions.vsStartOfLineOptionsFirstText, 4)
   objSel.DeleteLeft(6)
   objSel.DestructiveInsert("NEW TEXT")
End Sub

Sub Position(ByVal pos As vsStartOfLineOptions, ByVal ipos As Integer)
   ' Moves the insertion point down to the beginning of the next line, 
   ' then highlights the right-most four characters.
   objSel.LineDown()
   objSel.StartOfLine(vsStartOfLineOptions.vsStartOfLineOptionsFirstText)
   objSel.CharRight(True, 4)
End Sub

See Also

Applies To: TextSelection Object

Show: