Delphi 2010 Formatter. Иллюстрированный справочник. Раздел Indentation

Источник: webdelphi

Источник: webdelphi

Одним из нововведений в Delphi 2010 является встроенный форматировщик исходного кода. Не знаю как Вы, а я был очень рад, что наконец-то можно не заморачиваться над чужими листингами в поисках истины, вручную добавлять пробелы, переносы строк и т.д. и т.п.

format_c

Теперь всю эту муторную работу целиком и полностью берет на себя Formatter Delphi 2010.
В целом можно сказать, что настройки по умолчанию рассчитаны на то, что максимальное количество пользователей будут использовать форматтер без каких либо дополнительных настроек. Однако, как ни крути, а у каждого есть свои предпочтения в оформлении, каждый привык к своему виду исходного кода. Несмотря на то, что настройки по форматеру Delphi максимально снабжены пояснениями, я решил немного покопаться в его настройках и составить подробное описание этого замечательного нового инструмента Delphi.  И вот, что у меня в итоге получилось.

1. Общие сведения о Delphi Formatter

Для того, чтобы получить доступ к настройкам форматировщика исходного кода Delphi необходимо в главном меню выбрать:
Tools -> Options -> Formatter -> Delphi

Delphi Formatter

Все опции содержаться в четырех разделах:

  • Indentation - отступы
  • Spaces - пробелы
  • Line Breaks - переносы строк
  • Capitalization - капитализация

Каждый раздел состоит из ряда секций. Рассмотрим более подробно все настройки у Formatter"а.

2. Настройки форматировщика исходного кода Delphi

Раздел Indentation (отступы)

Секция General

Continuation ident (продолжение отступа)
тип значения : число
значение по умолчанию: 2
описание: определяет дополнительный абзац, который добавляется для продолжения строк, когда выражение продолжается на нескольких строках.

Continuation indent

Do not indent after position (не делать отступ после позиции)
тип значения : число
значение по умолчанию: 40
описание: определяет позицию для отступа. Отступ будет вставляться только до позиции, не превышающей это значение

Do not indent after position

Indent Begin and End keywords (отступы для ключевых слов begin…end)
тип значения : true/false
значение по умолчанию: false
описание: если true, то перед begin и end будет делаться отступ

Indent Begin and End keywords

Indent bloks between Begin and End (отступы блоков между begin и end)
тип значения : true/false
значение по умолчанию: true
описание: если true, то для блоков кода между ключевыми словами begin и end будет делаться отступ

Indent bloks between Begin and End

Indent class definition body (отступы в теле определения класса)
тип значения : true/false
значение по умолчанию: false
описание: если true, то в теле класса будут делаться отступы для каждой секции

Indent class definition body

Indent comments (отступы комментариев)
тип значения : true/false
значение по умолчанию: true
описание: если true, то комментарии будут оформлены в соответствии с окружающим текстом

indent comments

Indent Compiler directives (отступы директив компилятора)
тип значения : true/false
значение по умолчанию: false
описание: если False, то все директивы компилятора будут располагаться по левому краю без отступов

Indent Compiler directives

Indent interface, implementation, and other sections (отступы в секциях)
тип значения : true/false
значение по умолчанию: false
описание: если true, то весь код в секциях модуля (interface, implementation и т.д.) будет сопровождаться отступами

Indent interface

Indent nested routines (отступы вложенных процедур)
тип значения : true/false
значение по умолчанию: true
описание: если true, то весь код вложенных процедур будет с отступами по отношению к главной процедуре

indent nested routines

Indent routine bodies (отступы тела процедуры)
тип значения : true/false
значение по умолчанию: false
описание: если true, то тело процедуры будет оформляться дополнительными отступами

Indent routine bodies

Секция Indentation for case statements
(отступы конструкции case)

Indent case contents (отступы содержимого конструкции case)
тип значения : true/false
значение по умолчанию: true
описание: если true, то всё содержимое конструкции после метки case будет дополнено отступами относительно слова case .

Indent case contents

Indent case labels (отступы меток)
тип значения : true/false
значение по умолчанию: true
описание: если true, то метки конструкции будут дополняться отступами

indent case labels

Indent Else in case statements (отступы else в конструкции case)
тип значения : true/false
значение по умолчанию: false
описание: если true, то else в конструкции будет дополнен отступами

Indent Else in case statements

Секция Indentation for labels (отступы меток)

Indent labels (отступы меток)
тип значения : выбор из списка
значение по умолчанию: Decrease one indent (отделение одним отступом)
описание:
To left margin - метка помещается в крайний левый столбец

Labels left

Decrease one indent - метка помещается через одну строку после оператора goto

Labels decrease

None - метка помещается на том же уровне, что и оператор goto

Labels none


Страница сайта http://test.interface.ru
Оригинал находится по адресу http://test.interface.ru/home.asp?artId=23464