ВыровнятьМногострочныйТекст (AlignMultilineText)

Описание:

Функция возвращает массив строк, полученный путем разбивки (при необходимости) входного текстового аргумента на строки заданного размера. Разбивка происходит по возможности по пробелам.

Синтаксис:

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

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

Параметры:

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

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

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

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

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

Массив строк, полученный путем разбивки (при необходимости) входного текстового аргумента на строки заданного размера. Разбивка происходит по возможности по пробелам.

Пример:

//В примере выравнивается по центру многострочный текст

Перем МассивСтрок;
 

МассивСтрок = ВыровнятьМногострочныйТекст("Текст надо разбить на строки", 1, 6, ".");
//Результат: массив [ "Текст.", ".надо.", "разбит", ".ь на.", "строки" ]