TextSelection.DestructiveInsert Method
Inserts text, overwriting the existing text.
Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)
Syntax
'Declaration
Sub DestructiveInsert ( _
Text As String _
)
void DestructiveInsert(
string Text
)
void DestructiveInsert(
[InAttribute] String^ Text
)
abstract DestructiveInsert :
Text:string -> unit
function DestructiveInsert(
Text : String
)
Parameters
Text
Type: System.StringRequired. Represents the text to insert.
Remarks
Newline characters cause the text selection's active end to move to the beginning of the next line. It may also insert indentation depending on the language used in the text document.
Examples
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,
' and then highlights the right-most four characters.
objSel.LineDown()
objSel.StartOfLine(vsStartOfLineOptions.vsStartOfLineOptionsFirstText)
objSel.CharRight(True, 4)
End Sub
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.