TextSelection.Indent Method

Indents the selected lines by the given number of indentation levels.

Namespace:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

Syntax

'Declaration
Sub Indent ( _
    Count As Integer _
)
void Indent(
    int Count
)
void Indent(
    [InAttribute] int Count
)
abstract Indent : 
        Count:int -> unit
function Indent(
    Count : int
)

Parameters

  • Count
    Type: System.Int32

    Optional. The number of display indent levels to indent each line in the text selection. The default is 1.

Remarks

Indent indents the text selection by the number of display columns indicated by the global setting for one indentation level. Indent does not do smart formatting or indent lines based on the context of the code. Tabs and spaces are inserted, depending on the global setting for whether to use tabs when indenting. The indentation may consist of multiple tab and space characters, depending on the global setting for how many spaces a tab equals.

Indent behaves differently depending on whether the text selection is continuous or columnar. If it is continuous, all lines partially or completely within the selection, are indented at the first column. If it is a columnar selection, the text selection is indented at the left edge of the selection.

Indent behavior depends on whether the text selection is the entire line or only a portion of it. If only a portion of the line is selected, the selected portion is deleted and the remainder is indented either one indent level or Count number of columns.

If the value of Count is negative, then Indent performs like the Unindent method.

Indent fails if the value of Count is greater than or equal to 10,000.

Examples

Sub IndentExample()
   ' Before running this example, open a text document.
   Dim objSel As TextSelection = DTE.ActiveDocument.Selection
   ' Go to first line in document and indent it.
   objSel.GotoLine(1, False)
   objSel.Indent(1)
End Sub

.NET Framework Security

See Also

Reference

TextSelection Interface

EnvDTE Namespace