Формат HTML (HyperText Markup Language) - стандартный язык разметки документов во Всемирной паутине. Большинство web-страниц создаются при помощи языка HTML. Язык HTML интерпретируется браузером и отображается в виде документа, в удобной для человека форме. HTML — это теговый язык разметки документов. Любой документ на языке HTML представляет собой набор элементов, причем начало и конец каждого элемента обозначается специальными пометками — тегами. Элементы могут быть пустыми, то есть не содержащими никакого текста и других данных (например, тег перевода строки <br>). В этом случае обычно не указывается закрывающий тег. Кроме того, элементы могут иметь атрибуты, определяющие какие-либо их свойства (например, размер шрифта для элемента font). Атрибуты указываются в открывающем теге.

 

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

 

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

 

Название

Тип

Описание

Zoom

double

коэффициент масштабирования. По умолчанию установлено значение 1.0, что равно 100% в окне настройки экспорта

ImageFormat

ImageFormat

устанавливает, в каком формате будут экспортироваться изображения документа; по умолчанию ImageFormat.Png

ExportMode

StiHtmlExportMode

устанавливает режим экспорта документа - с использованием элементов div, span или table; по умолчанию StiHtmlExportMode.Table

ExportQuality

StiHtmlExportQuality

качество экспорта размеров компонентов; по умолчанию StiHtmlExportQuality.High

Encoding

Encoding

кодировка выходного файла; по умолчанию Encoding.UTF8

AddPageBreaks

bool

добавлять разделители страниц; по умолчанию false

BookmarksTreeWidth

int

ширина колонки закладок, в пикселях; по умолчанию 150

ExportBookmarksMode

StiHtmlExportBookmarksMode

режим экспорта документа с закладками; по умолчанию StiHtmlExportBookmarksMode.All

UseStylesTable

bool

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

 

 

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

 

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

 

Название

Тип

Описание

ConvertDigitsToArabic

bool

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

ArabicDigitsType

enum

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

AllowImageComparer

bool

использовать оптимизатор изображений, т.е. удалять дубликаты изображений (см. Common export settings); если false - изображения передаются как есть; по умолчанию true

ForceWysiwygWordwrap

bool

принудительно разбивать текст на строки так же, как в режиме WYSIWYG; по умолчанию false

ReplaceSpecialCharacters

bool

заменять символы '<', '>', '&', ' " ' конструкциями &lt; &gt; &amp; &quot; по умолчанию true