TRichView.OnWriteObjectProperties

Происходит при сохранении элемента документа в RTF, DocX или HTML; позволяет сохранить дополнительные свойства.

type

  // объявлено в модуле RVStyle/fmxRVStyle
  TRVObjectExportProperties = record
    Id, Name: TRVUnicodeString;
  end;

type
  TRVWriteObjectPropertiesEvent = procedure(Sender: TCustomRichView;
    RVData: TCustomRVData; ItemNo: Integer;

SaveFormat: TRVSaveFormat;
var Props: TRVObjectExportProperties) of object;

property OnWriteObjectProperties: TRVWriteObjectPropertiesEvent;

Событие вызывается при сохранении элементов документа следующих типов:

▪рисунки и интерактивные рисунки;

▪значки и интерактивные значки;

▪маркеры списка, содержащие изображения;

▪математические выражения;

▪фигуры (в Мастерской отчётов (Report Workshop)).

Все эти объекты экспортируются как изображения.

Входные параметры:

RVData – документ, содержащий элемент (RVData основного TRichView, ячейка, или RVData редактора ячейки).

ItemNo – номер элемента в RVData.

SaveFormat может быть rvsfHTML or rvsfRTF или rvsfDocX

Props содержит начальные значения свойств.

Выходные параметры:

Props содержит значения свойств, которые будут сохранены в файл.

Сохраняемые свойства

Props.Id содержит идентификатор объекта. Если указан, он должен быть уникальным в документе.

Format	Начальное значение Id	Требования к Id
rvsfRTF	'' (пустая строка)	Если пустая строка, идентификатор не сохраняется. В противном случае это должно быть целочисленное значение, закодированное как строка. Мы настоятельно рекомендуем использовать отрицательные числа для идентификаторов изображений RTF (нулевые или небольшие положительные значения могут привести к повреждению изображения).
rvsfDocX	Целое число, закодированное в виде строки. Это число генерируется автоматически при сохранении в формате DocX и может быть изменено при каждом сохранении.	Идентификатор должен представлять собой уникальное целочисленное значение, закодированное в виде строки.
rvsfHTML	'' (пустая строка)	Если пустая строка, идентификатор не сохраняется. В противном случае это должна быть строка, начинающаяся с буквы (['A'..'Z','a'..'z']), за которой идёт любое число символов букв, цифр (['0'..'9']), дефисов ('-'), подчёркиваний ('_'), двоеточий (':') и точек ('.').

Format

Начальное значение Id

Требования к Id

rvsfRTF

'' (пустая строка)

Если пустая строка, идентификатор не сохраняется.

В противном случае это должно быть целочисленное значение, закодированное как строка. Мы настоятельно рекомендуем использовать отрицательные числа для идентификаторов изображений RTF (нулевые или небольшие положительные значения могут привести к повреждению изображения).

rvsfDocX

Целое число, закодированное в виде строки. Это число генерируется автоматически при сохранении в формате DocX и может быть изменено при каждом сохранении.

Идентификатор должен представлять собой уникальное целочисленное значение, закодированное в виде строки.

rvsfHTML

'' (пустая строка)

Если пустая строка, идентификатор не сохраняется.

В противном случае это должна быть строка, начинающаяся с буквы (['A'..'Z','a'..'z']), за которой идёт любое число символов букв, цифр (['0'..'9']), дефисов ('-'), подчёркиваний ('_'), двоеточий (':') и точек ('.').

Props.Name содержит имя объекта.

Format	Начальное значение Name	Требования к Name
rvsfRTF	'' (пустая строка)	Name не сохраняется, игнорируется.
rvsfDocX	'Pic N', где N равно начальному значению Prop.Id.	Любая строка без символов переноса строки.
rvsfHTML	'' (пустая строка)	Name не сохраняется, игнорируется.

TCustomRichView.OnWriteObjectProperties

TCustomRichView.OnWriteObjectProperties

Сохраняемые свойства