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

Источник: webdelphi

Одним из нововведений в 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

Ссылки по теме

• Купить продукты компании Embarcadero/CodeGear в интернет-магазине ITShop.ru
• Курсы обучения по продуктам компании Embarcadero/CodeGear в ITShop.ru