TCustomRichView.SetAddParagraphMode

<< Нажмите, чтобы показать Содержание >>

TCustomRichView.SetAddParagraphMode

Устанавливает режим добавления элементов документа с новой строки методами Add***.

procedure SetAddParagraphMode(AllowNewPara: Boolean);

По умолчанию (если SetAddParagraphMode не был вызван), все элементы, добавляемые с новой строки, начинают абзац.

Вы можете изменить этот режим вызовом SetAddParagraphMode(False), а затем вернуть начальный режим SetAddParagraphMode(True).

После вызова SetAddParagraphMode(False) элементы, добавляемые с новой строки, начинают не абзац, а новую строку внутри абзаца.

 

Предупреждение: используйте SetAddParagraphMode(False) с осторожностью:

не добавляйте первый элемент (или элемент после горизонтальной линии или таблицы) в этом режиме;

не переключайте стиль абзаца в этом режиме (все элементы в одном абзаце должны иметь один и тот же стиль абзаца).

См.: корректные документы

 

Пример 1:

with MyRichView do

begin

  Clear;

  SetAddParagraphMode(True); // режим по умолчанию

  AddNL('Первый',  00); // корректно, 1-й абзац стиля 0

  AddNL('Второй'00);  // корректно, 2-й абзац стиля 0

  AddNL('Третий',  01); // корректно, 3-й абзац стиля 1

end;

Пример 2:

with MyRichView do

begin

  Clear;

  SetAddParagraphMode(False);

  // ошибка, не добавляйте первый элемент в этом режиме!

  AddNL('Первый'00);

end;

Пример 3:

with MyRichView do

begin

  Clear;

  SetAddParagraphMode(True); // режим по умолчанию

  // корректно, 1-й абзац стиля 0

  AddNL('Первый',  00);

  SetAddParagraphMode(False);

  // корректно, новая строка в 1-м абзаце

  AddNL('Второй'00);

  // ошибка, не добавляйте элемент другого стиля абзаца

  // в этом режиме!

  AddNL('Третий',  01);

end;

 

См. также:

Абзацы;

Создание документа.