Rich Text Format (RTF) — свободный межплатформенный формат хранения размеченных текстовых документов, предложенный Microsoft. Первая версия стандарта RTF появилась в 1987 году, с тех пор спецификация формата несколько раз изменялась и дополнялась. RTF-документы поддерживаются большинством современных текстовых редакторов. Под Microsoft Windows это, как правило, осуществляется с помощью стандартных библиотек, входящих в состав системы.

 

Параметры экспорта

 

Параметры экспорта в формат RTF описываются в классе StiRtfExportSettings. Ниже приводится таблица с описанием всех свойств этого класса.

 

Название

Тип

Описание

ImageQuality

float

качество изображений; может принимать значение от 0.0 (низкое качество) до1.0 (высокое качество); по умолчанию 0.75

ImageResolution

float

разрешение изображений, точек на дюйм; может принимать любое значение, по умолчанию 100

UsePageHeadersAndFooters

bool

обрабатывать хэдеры и футеры страницы (см. Table mode); по умолчанию false

ExportMode

enum

выбор режима экспорта (см. Common knowledge); по умолчанию StiRtfExportMode.Table

CodePage

int

свойство устарело и больше не используется, оставлено для совместимости с ранними версиями

 

 

Статические параметры

 

Кроме класса StiRtfExportSettings параметры экспорта в RTF также задаются при помощи статических свойств. Каждое свойство имеет глобальное влияние на любой экспорт в формат RTF из кода или при помощи Web или WinForms Viewer-а. Все свойства с описанием приведены ниже. Для доступа к свойствам нужно добавлять префикс StiOptions.Export.Rtf... например, StiOptions.Export.Rtf.UsePageRefField.

 

Название

Тип

Описание

UsePageRefField

bool

при экспорте оглавления с номерами страниц (например, отчет "Anchors") использовать для номеров страниц команду MS-Word "PAGEREF" - номера страниц в оглавлении будут динамически изменяться при изменении отчета; если false - номера страниц будут статические; по умолчанию true

ConvertDigitsToArabic

bool

конвертировать ASCII цифры в арабские цифры; по умолчанию false

ArabicDigitsType

enum

выбор типа арабских цифр; по умолчанию Standard

DivideSegmentPages

bool

разбивать сегментированные страницы на отдельные страницы выбранного формата; если false - страницы передаются как есть, без разбивки на части; по умолчанию true

LineHeightExactly

bool

экспортировать высоту строк таблицы "точно" ("exactly"); если false - высота строк экспортируется как "минимум" ("at least"); по умолчанию true

RemoveEmptySpaceAtBottom

bool

вырезать пустое пространство снизу страницы; по умолчанию true

LineSpacing

double

коэффициент корректировки высоты строки в многострочных текстовых полях; по умолчанию 0.965

RightMarginCorrection

int

величина коррекции правого поля ячейки; по умолчанию 0

SpaceBetweenCharacters

int

устанавливает разреженный или уплотненный интервал шрифта, в твипсах (twips); отрицательное значение соответствует уплотнению; по умолчанию -2

UseCanBreakProperty

bool

использовать свойство CanBreak при экспорте каждой строки таблицы; по умолчанию true

DivideBigCells

bool

разбивать очень высокие ячейки на более мелкие для удобства редактирования и скроллирования; по умолчанию true