Формат 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
|
заменять символы '<', '>', '&', ' " ' конструкциями < > & " по умолчанию true
|
|