Текстовый блок – это упрощённая версия сноски в рамке. Он отличается тем, что в месте вставки этого элемента нет видимого текста.
Если опция rvoShowSpecialCharacters включена в TRichView.Options, в местах вставки текстовых блоков показываются специальные знаки.
Текстовый блок содержит поддокумент. Этот поддокумент не отображается в TCustomRichView, куда он вставлен, но его можно распечатать компонентом TRVPrint: он отображается в прямоугольнике по заданным координатам.
Компонент TRVReportHelper не показывает текстовые блоки. Если нужно нарисовать документ с текстовыми блоками на заданной канве, используйте TRVPrint в режиме виртуального принтера.
Примечание о СРВ-Редакторе (ScaleRichView): компонент TSRichViewEdit показывает и даёт редактировать текстовые блоки.
Класс этого типа элемента: TRVTextBoxItemInfo (см. для подробной информации).
Тип (стиль) этого элемента: rvsTextBox (-207)
Методы TCustomRichView
Следующие методы быстрого изменения документа добавляют элемент этого типа в конец документа:
▪AddItem (создайте объект TRVTextBoxItemInfo, затем добавьте в документ методом AddItem)
Следующие методы возвращают объект TRVTextBoxItemInfo:
Методы TCustomRichViewEdit
Следующие методы редактирования документа вставляют элемент этого типа в позицию каретки:
▪InsertItem (создайте объект TRVTextBoxItemInfo, затем вставьте в документ методом InsertItem)
Следующие методы возвращают объект TRVTextBoxItemInfo в позиции каретки:
Следующие методы меняют свойства как операции редактирования:
▪SetCurrentItemExtraIntPropertyEx;
▪SetCurrentItemExtraStrPropertyEx;
Свойства
Текстовые блоки имеют все свойства сносок в рамке, но почти все из них игнорируются.
Используются только свойства, относящиеся к плавающему прямоугольнику: BoxPosition и BoxProperties.
Сохранение и загрузка
Экспорт HTML
Текстовые блоки не сохраняются в HTML.
RTF и DocX
Текстовые блоки записываются в RTF и DocX и читаются из DocX.
См. комментарии в разделе сносках в рамке для получения информации о совместимости с Microsoft Word.
Markdown
Текстовые блоки сохраняются как сноски, если активно расширение формата со сносками (опция rvmdeFootnotes включена TRichView.MarkdownProperties.Extensions), и опция rvntTextBox включена TRichView.MarkdownProperties.NotesSavedAsFootnotes.
В противном случае документ текстового блока сохраняется в месте вставки в квадратных скобках.
Если активно расширение формата с таблицами, текстовые блоки в ячейках таблиц не могут быть сохранены.
Текст
При копировании или сохранении выделенного текста текстовые блоки не включаются в текст. При сохранении всего текста они сохраняются в месте вставки в квадратных скобках:
Это текст [последовательность символов] для показа текстовых блоков
[текст, показываемый в прямоугольной области].