TextSelection.Indent - метод

Статья
11/05/2008

Обновлен: Ноябрь 2007

Создает в выделенных строках отступ заданного уровня.

Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.dll)

Синтаксис

'Декларация
Sub Indent ( _
    Count As Integer _
)
'Применение
Dim instance As TextSelection
Dim Count As Integer

instance.Indent(Count)

void Indent(
    int Count
)

void Indent(
    [InAttribute] int Count
)

function Indent(
    Count : int
)

Параметры

Count
Тип: System.Int32
Необязательный компонент. Число отображаемых уровней отступа, на которые следует отступить в каждой строке выделенного текста. По умолчанию используется значение 1.

Заметки

Indent делает отступ в выделенном тексте на число отображаемых столбцов, которое определяется глобальным параметром, задающим величину одного уровня отступа. Indent не выполняет улучшенное форматирование или добавление отступов, основываясь на контексте кода. Может выполняться вставка знаков табуляции и пробелов в зависимости от глобального параметра, определяющего необходимость использования знаков табуляции при отступе. Отступ может включать несколько знаков табуляции и пробелов в зависимости от глобального параметра, который определяет число пробелов, эквивалентное одному шагу табуляции.

Indent действует по-разному в зависимости от того, является текст непрерывным или состоит из столбцов. Если это непрерывный текст, то во всех строках, частично или полностью попавших в выделенный фрагмент, делается отступ в первом столбце. Если выделенный текст состоит из столбцов, отступ делается с левого края выделенного фрагмента.

Результаты выполнения Indent также зависят от того, выделена целая строка или только ее часть. Если выделена только часть строки, эта часть удаляется, а остальная часть сдвигается на один уровень отступа или на Count столбцов.

Если значение Count отрицательно, то Indent выполняется идентично методу Unindent.

Indent выдает ошибку, если значение Count больше либо равно 10,000.

Примеры

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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

TextSelection Интерфейс

TextSelection - члены

EnvDTE - пространство имен

Поделиться через