|
<< Нажмите, чтобы показать Содержание >> Новое в версии 14 |
•Теги элементов документа теперь являются строками, а не целыми числами. Значение тега по умолчанию изменено с 0 на ''. Если вы использовали теги в целочисленном режиме, используйте StrToInt и IntToStr при вызове методов TRichView, возвращающих и принимающих теги. Это касается не только методов с тегами-параметрами, но и некоторых событий (OnReadHyperlink, OnRVControlNeeded). В существующих проектах измените типы параметров-тегов обработчиков этих событий вручную с Integer на TRVTag. В файле RV_Defs.inc можно определить RVOLDTAGS, чтобы сделать теги целочисленными (не рекомендуется).
•Параметры события OnRVFPictureNeeded были изменены. Если вы использовали это событие, измените его обработчики вручную (или удалите старый обработчик событий и создайте новый).
•Для повёрнутых ячеек координаты, хранящиеся в свойстве DrawItems (низкоуровневое недокументированное свойство), не определяют положение элементов на экране напрямую.
•TRichView.LoadText, LoadTextFromStream, SaveText, SaveTextToStream, TRichViewEdit.InsertTextFromFile имеют новый параметр. Этот параметр необязателен, но в старых версиях C++Builder его необходимо явно добавлять в код (для совместимости используйте CP_ACP).
•Поведение текстового поиска можно изменить с помощью новой опции «умный старт» (см. TRichView.SearchText и TRichViewEdit.SearchText). GetRVSearchOptions и GetRVESearchOptions возвращают эту опцию по умолчанию, поэтому она может повлиять на существующие проекты.
•Изменения в процедуре переноса юникодных строк: символы '.', '!', ',', ';' теперь обрабатываются (почти) как буквенные символы (поскольку они часто используются в фразах типа '.Net' или в URL-адресах).
•Изменения в компонентах для работы базами данных: если опция rvfoLoadBack присутствует в RVFOptions, TDBRichView очищает BackgroundBitmap перед загрузкой данных из своего поля. Если параметр rvfoLoadBack присутствует в RVFOptions и FieldFormat=rvdbRVF, TDBRichViewEdit очищает BackgroundBitmap перед загрузкой данных из своего поля.
•Изображения PNG сохраняются в RTF как изображения PNG только в том случае, если опция rvrtfSavePngAsPng включена в RTFOptions. Она включена по умолчанию. Однако для существующих проектов может потребоваться установить её вручную.
•Определение типа TRVLongOperation было изменено.
•Из файла RVTable.pas были удалены следующие глобальные переменные: RichViewTableGridStyle, RichViewTableGridStyle2, RichViewTableGridColor. Они были заменены свойствами TRVStyle.
•В TRichView.Options по умолчанию включена опция rvoShowGridLines, но для существующих проектов может потребоваться установить её вручную, иначе линии сетки таблиц не будут отображаться по умолчанию.
StyleTemplates (шаблоны стилей) представляют собой «настоящие» стили текста и абзацев. При использовании шаблонов стилей внешний вид текста и абзацев по-прежнему определяется в TextStyles и ParaStyles. Элементы документа ссылаются на элементы в TextStyles и ParaStyles, а элементы в TextStyles и ParaStyles ссылаются на элементы в StyleTemplates. Шаблоны стилей позволяют изменять TextStyles и ParaStyles.
По умолчанию шаблоны стилей не используются. Чтобы активировать использование шаблонов стилей, присвойте TRichView.UseStyleTemplates=True.
TRichView.StyleTemplateInsertMode определяет, как шаблоны стилей влияют на вставку данных RVF и RTF.
При изменении набора шаблонов стилей происходит событие OnStyleTemplatesChange.
В TRichViewEdit вы можете применить указанный шаблон стиля к выделенному фрагменту документа с помощью методов: ApplyStyleTemplate, ApplyTextStyleTemplate, ApplyParaStyleTemplate. Шаблоны стилей можно редактировать с помощью метода ChangeStyleTemplates.
Функция RVGetNoteTextStyleNo имеет дополнительный необязательный параметр: имя шаблона стиля, используемого для символа сноски.
Свойство TRVStyle.MainRVStyle позволяет использовать одну коллекцию шаблонов стилей для нескольких документов.
См. обзорный раздел справки о шаблонах стилей.
Содержимое ячеек таблиц может быть повёрнуто на 90°, 180° или 270°.
Добавлен новый метод, возвращающий координаты элемента документа: GetItemCoordsEx; он учитывает вращение ячейки.
Начиная с версии 13.2, теги элементов документа стали строками (юникодными для Delphi 2009 и новее, ANSI для более старых версий Delphi). Больше не нужно приведение типа Integer к PChar!
Новое свойство: теги ячеек.
В RAD Studio XE2+ поддерживаются как 32-битные, так и 64-битные компиляторы.
Примечание: TRVOfficeConverter может быть скомпилирован в 64-битном приложении, но списки конвертеров будут пустыми (поскольку конвертеры представляют собой 32-битные DLL-файлы и не могут использоваться в 64-битных приложениях).
Компоненты поддерживают визуальные стили пользовательского интерфейса, представленные в RAD Studio XE2:
▪Все визуальные компоненты отображают полосы прокрутки и рамки в соответствии со стилями;
▪TRVPrintPreview корректирует цвета (фон, рамка страницы, тень) в соответствии с текущим стилем.
Новый необязательный параметр для TRichView.LoadText, LoadTextFromStream, SaveText, SaveTextToStream, TRichViewEdit.InsertTextFromFile: CodePage. Он позволяет указать кодовую страницу файла (этот параметр используется только для юникодного текста в документе; для текста в формате ANSI он игнорируется).
Перетаскивание: при приёме текстовых файлов TRichViewEdit определяет их кодировку (UTF16, UTF8 или ANSI).
При сохранении текста в формате Юникод символы шрифтов «Symbol» и «Wingdings» преобразуются в наиболее похожие символы Юникода.
Свойство VAlign значков and интерактивных значков сохраняется в RVF.
Параметры события TRichView.OnRVFPictureNeeded были изменены. Теперь это событие вызывается не только для рисунков и интерактивных рисунков, но и для таблиц и ячеек таблиц для чтения фоновых изображений. Это изменение решило следующие проблемы:
▪возможность запроса фоновых изображений для таблиц и ячеек;
▪доступ к дополнительным свойствам элементов документа.
Новая опция в TRichView.RTFOptions: rvrtfSavePngAsPng. Если включена (по умолчанию), изображения PNG (класса, зарегистрированного в RV_RegisterPngGraphic) сохраняются как PNG в формате RTF (как и до этой версии). Вы можете исключить эту опцию, чтобы сохранять их как Bitmap или метафайл..
Действия по умолчанию в случае, если обработчик события OnReadHyperlink/OnWriteHyperlink не назначен.
TRichView.SaveHTMLEx может сохранять растянутые фоновые изображения (ранее они сохранялись центрированными).
TRichView.SaveHTMLEx лучше сохраняет маркеры списков (как в обычном режиме, так и в режиме rvsoMarkersAsText).
Новые «скрытые» параметры в событии TRichView.OnSaveImage2.
Действия по умолчания в случае, если обработчик события OnWriteHyperlink не назначен.
SaveHTMLEx сохраняет символы шрифтов «Symbol» и «Wingdings» как наиболее похожие символы Юникода (ранее это было реализовано только для «Symbol», теперь улучшено).
▪Улучшено отображение фона текста, добавлено новое свойство TRVStyle.TextBackgroundKind.
▪Все смежные гипертекстовые элементы с одинаковыми непустыми тегами подсвечиваются под указателем мыши, поэтому визуально они представляют собой одну гиперссылку.
▪Новые свойства для нетекстовых элементов: цвет фона, ширина и цвет рамки, поля вокруг рамки.
▪Символы сноски и концевой сноски остаются на той же строке, что и предыдущий элемент документа.
▪Улучшен расчёт положения верхнего индекса.
Новое: TRichViewEdit может вставлять URL-адреса. Доступен новый метод: PasteURL.
Новое свойство: AcceptPasteFormats позволяет ограничить список форматов, которые редактор может вставлять.
Новое свойство: DefaultPictureVAlign определяет выравнивание для вставляемых и перетаскиваемых изображений.
Если опция rvfoLoadBack включена в RVFOptions, TDBRichView очищает BackgroundBitmap перед чтением из своего поля.
Если опция rvfoLoadBack включена в RVFOptions и FieldFormat=rvdbRVF, TDBRichViewEdit очищает BackgroundBitmap перед чтением из своего поля.
Таблицы
Новое свойство строки таблицы: KeepTogether. Новые методы таблицы: SetRowPageBreakBefore, SetRowKeepTogether.
Новая опция для table.PrintOptions: rvtoContinue.
Другое
Новое свойство: TCustomRVPrint.IgnorePageBreaks.
Новые свойства TRVStyle, определяющие внешний вид линий сетки: GridColor, GridStyle, GridReadOnlyColor, GridReadOnlyStyle. Они заменяют глобальные переменные, использовавшиеся в более старых версиях. Новая опция rvoShowGridLines в TRichView.Options.
Улучшена обработка нажатий клавиш ↑ и ↓ при выходе и входе в ячейку таблицы.
Новое событие TRichViewEdit: OnCheckStickingItems позволяет «склеить» элементы документа.
Новая типизированная константа: RichViewDoNotMergeNumbering.
Опция поиска «умный старт» для TRichView.SearchText и TRichViewEdit.SearchText.
Теперь событие TRichView.OnProgress срабатывает не только при чтении RTF-файла, но и при сохранении RTF-файла, чтении и записи RVF-файла, записи HTML-файла, чтении и записи текста, а также при вызове методов TRVOfficeConverter.ImportRV и ExportRV.
Улучшен алгоритм расчёта ширины таблиц.
Новые методы для TRVStyle: FindTextStyle, FindParaStyle, TextStyles.FindSuchStyleEx, ParaStyles.FindSuchStyleEx.