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

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

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

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

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

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

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

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

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

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

Секция General

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В следующей статье я продолжу рассмотрение возможностей форматировщика кода Delphi.

Книжная полка

	Автор: Дмитрий Осипов Название: Delphi. Программирование для Windows, OS X, iOS и Android Описание Подробно рассматривается библиотека FM, позволяющая создавать полнофункциональное программное обеспечение для операционных систем Windows и OS X, а также для смартфонов и планшетных компьютеров, работающих под управлением Android и iOS
	Автор: Андрей Шкрыль Название: Разработка клиент-серверных приложений в Delphi Описание: Рассмотрены практические вопросы по разработке клиент-серверных приложений в среде Delphi 7 и Delphi 2005 с использованием СУБД MS SQL Server 2000, InterBase и Firebird. Приведена информация о теории построения реляционных баз данных и языке SQL. Освещены вопросы эксплуатации и администрирования СУБД.
	Автор: Антон Григорьев Название: О чем не пишут в книгах по Delphi Описание: Рассмотрены малоосвещенные вопросы программирования в Delphi. Описаны методы интеграции VCL и API. Показаны внутренние механизмы VCL и приведены примеры вмешательства в эти механизмы. Рассмотрено использование сокетов в Delphi: различные режимы их работы, особенности для протоколов TCP и UDP и др.
	Автор: Дмитрий Осипов Название: Delphi. Профессиональное программирование Описание: Книга рассчитана на подготовленного пользователя ПК, желающего самостоятельно научиться программировать и разрабатывать приложения и базы данных в среде Delphi. Опытные программисты смогут использовать издание как справочник. В тексте подробно описаны более 80 компонентов VCL, функции Object Pascal и Win32 API.
	Автор: Юрий Магда Название: Разработка приложений Microsoft Office 2007 в Delphi Описание: Описаны общие подходы к программированию приложений MS Office. Даны программные методы реализации функций MS Excel, MS Word, MS Access и MS Outlook в среде Delphi.