ВыровнятьТекст (AlignText)

Описание:

Функция формирует строку  с учетом  выравнивания.

Синтаксис:

ВыровнятьТекст(<ИсходнаяСтрока>, <ТипВыравнивания>, <ДлинаСтроки>, <СимволЗаполнения>)

AlignText(<String>, <AlignType>, <StringLength>, <Symbol>)

Параметры:

ИсходнаяCтрока (String) – строка, которую необходимо выровнять. Параметр является обязательным.

ТипВыравнивания (AlignType) – указывается одно из значений: 0 – выравнивание по левому краю, 1 – выравнивание по центру, 2 – выравнивание по правому краю.  Параметр является обязательным.

ДлинаСтроки (StringLength) – максимальная длинна строки, числовое значение. Значение должно быть не меньше "1". Если длина текста больше указанного в параметре значения, текст обрезается справа. Параметр является обязательным.

СимволЗаполнения (Symbol) – строковое значение. Если размер исходной строки меньше длины, указанной в параметре "ДлинаСтроки (StringLength)", то для заполнения пробелов в начале и конце строки будет использоваться первый символ параметра "СимволЗаполнения" ("Symbol"). Параметр не является обязательным. Если параметр не указан, то символом заполнения является " " (пробел).

Возвращаемые значения:

Строку, отформатированную в соответствии с заданными параметрами.

Пример:

//В примере возвращается строка, выровненная по центру с
//символами заполнения "*"
Стр = ВыровнятьТекст("Строка", 1, 12, "*");
//Результат: Стр = "***Строка***"