Aspose::Words::Loading::HtmlLoadOptions class

HtmlLoadOptions class

Позволяет указать дополнительные параметры при загрузке HTML‑документа в объект Документ. Чтобы узнать больше, посетите статью документации Указать параметры загрузки.

class HtmlLoadOptions : public Aspose::Words::Loading::LoadOptions

Методы

МетодОписание
Equals(System::SharedPtr<System::Object>) overrideОпределяет, равен ли указанный объект по значению текущему объекту.
get_BaseUri() constПолучает или задает строку, которая будет использоваться для преобразования относительных URI, найденных в документе, в абсолютные URI при необходимости. Может быть null или пустой строкой. По умолчанию null.
get_BlockImportMode() constПолучает или задает значение, указывающее, как свойства блочных элементов импортируются. Значение по умолчанию — Объединить.
get_ConvertMetafilesToPng() constПолучает или задает, следует ли конвертировать метафайлы (Wmf или Emf) в формат изображения Png.
get_ConvertShapeToOfficeMath() constПолучает или задает, следует ли конвертировать фигуры с EquationXML в объекты Office Math.
get_ConvertSvgToEmf() constПолучает или задает значение, указывающее, следует ли конвертировать загруженные SVG‑изображения в формат EMF. Значение по умолчанию — false, и, если возможно, загруженные SVG‑изображения сохраняются без изменения.
get_Encoding() constПолучает или задает кодировку, которая будет использоваться для загрузки HTML, TXT или CHM‑документа, если кодировка не указана внутри документа. Может быть null. По умолчанию null.
get_FontSettings() constПозволяет задавать параметры шрифтов документа.
get_IgnoreNoscriptElements() constПолучает или задает значение, указывающее, следует ли игнорировать элементы HTML
get_IgnoreOleData() constУказывает, следует ли игнорировать данные OLE.
get_LanguagePreferences() constПолучает предпочтения языка, которые будут использоваться при загрузке документа.
get_LoadFormat() constУказывает формат загружаемого документа. По умолчанию — Auto.
get_MswVersion() constПозволяет указать, что процесс загрузки документа должен соответствовать определённой версии MS Word. Значение по умолчанию — Word2019
get_Password() constПолучает или задает пароль для открытия зашифрованного документа. Может быть null или пустой строкой. По умолчанию — null.
get_PreferredControlType() constПолучает или задает предпочтительный тип узлов документа, которые будут представлять импортированные элементы и
get_PreserveIncludePictureField() constПолучает или задает, сохранять ли поле INCLUDEPICTURE при чтении форматов Microsoft Word. Значение по умолчанию — false.
get_ProgressCallback() constВызывается во время загрузки документа и принимает данные о прогрессе загрузки.
get_RecoveryMode() constОпределяет, как следует обрабатывать документ при возникновении ошибок во время загрузки. Используйте это свойство, чтобы указать, должна ли система пытаться восстановить документ или следовать другому определённому поведению. Значение по умолчанию — TryRecover.
get_ResourceLoadingCallback() constПозволяет управлять тем, как внешние ресурсы (изображения, таблицы стилей) загружаются при импорте документа из HTML, MHTML.
get_SupportFontFaceRules() constПолучает или задает значение, указывающее, поддерживать ли правила @font-face и загружать объявленные шрифты. Значение по умолчанию — false.
get_SupportVml() constПолучает или задает значение, указывающее, поддерживать ли изображения VML.
get_TempFolder() constПозволяет использовать временные файлы при чтении документа. По умолчанию это свойство равно null, и временные файлы не используются.
get_UpdateDirtyFields() constУказывает, следует ли обновлять поля с атрибутом dirty.
get_UseSystemLcid() constПолучает или задает, использовать ли значение LCID, полученное из реестра Windows, для определения полей страницы по умолчанию.
get_WarningCallback() constВызывается во время операции загрузки, когда обнаружена проблема, которая может привести к потере точности данных или форматирования.
get_WebRequestTimeout() constКоличество миллисекунд ожидания до истечения времени запроса. Значение по умолчанию — 100000 миллисекунд (100 секунд).
GetType() const override
HtmlLoadOptions()Инициализирует новый экземпляр этого класса со значениями по умолчанию.
HtmlLoadOptions(const System::String&)Сокращение для инициализации нового экземпляра этого класса с указанным паролем для загрузки зашифрованного документа.
HtmlLoadOptions(Aspose::Words::LoadFormat, const System::String&, const System::String&)Сокращение для инициализации нового экземпляра этого класса со свойствами, установленными в указанные значения.
Is(const System::TypeInfo&) const override
LoadOptions()Инициализирует новый экземпляр этого класса со значениями по умолчанию.
LoadOptions(const System::String&)Сокращение для инициализации нового экземпляра этого класса с указанным паролем для загрузки зашифрованного документа.
LoadOptions(Aspose::Words::LoadFormat, const System::String&, const System::String&)Сокращение для инициализации нового экземпляра этого класса со свойствами, установленными в указанные значения.
set_BaseUri(const System::String&)Сеттер для Aspose::Words::Loading::LoadOptions::get_BaseUri.
set_BlockImportMode(Aspose::Words::Loading::BlockImportMode)Сеттер для Aspose::Words::Loading::HtmlLoadOptions::get_BlockImportMode.
set_ConvertMetafilesToPng(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_ConvertMetafilesToPng.
set_ConvertShapeToOfficeMath(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_ConvertShapeToOfficeMath.
set_ConvertSvgToEmf(bool)Сеттер для Aspose::Words::Loading::HtmlLoadOptions::get_ConvertSvgToEmf.
set_Encoding(const System::SharedPtr<System::Text::Encoding>&)Сеттер для Aspose::Words::Loading::LoadOptions::get_Encoding.
set_FontSettings(const System::SharedPtr<Aspose::Words::Fonts::FontSettings>&)Сеттер для Aspose::Words::Loading::LoadOptions::get_FontSettings.
set_IgnoreNoscriptElements(bool)Сеттер для Aspose::Words::Loading::HtmlLoadOptions::get_IgnoreNoscriptElements.
set_IgnoreOleData(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_IgnoreOleData.
set_LoadFormat(Aspose::Words::LoadFormat)Сеттер для Aspose::Words::Loading::LoadOptions::get_LoadFormat.
set_MswVersion(Aspose::Words::Settings::MsWordVersion)Сеттер для Aspose::Words::Loading::LoadOptions::get_MswVersion.
set_Password(const System::String&)Сеттер для Aspose::Words::Loading::LoadOptions::get_Password.
set_PreferredControlType(Aspose::Words::Loading::HtmlControlType)Сеттер для Aspose::Words::Loading::HtmlLoadOptions::get_PreferredControlType.
set_PreserveIncludePictureField(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_PreserveIncludePictureField.
set_ProgressCallback(const System::SharedPtr<Aspose::Words::Loading::IDocumentLoadingCallback>&)Вызывается во время загрузки документа и принимает данные о прогрессе загрузки.
set_RecoveryMode(Aspose::Words::Loading::DocumentRecoveryMode)Сеттер для Aspose::Words::Loading::LoadOptions::get_RecoveryMode.
set_ResourceLoadingCallback(const System::SharedPtr<Aspose::Words::Loading::IResourceLoadingCallback>&)Позволяет управлять тем, как внешние ресурсы (изображения, таблицы стилей) загружаются при импорте документа из HTML, MHTML.
set_SupportFontFaceRules(bool)Сеттер для Aspose::Words::Loading::HtmlLoadOptions::get_SupportFontFaceRules.
set_SupportVml(bool)Сеттер для Aspose::Words::Loading::HtmlLoadOptions::get_SupportVml.
set_TempFolder(const System::String&)Сеттер для Aspose::Words::Loading::LoadOptions::get_TempFolder.
set_UpdateDirtyFields(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_UpdateDirtyFields.
set_UseSystemLcid(bool)Сеттер для Aspose::Words::Loading::LoadOptions::get_UseSystemLcid.
set_WarningCallback(const System::SharedPtr<Aspose::Words::IWarningCallback>&)Вызывается во время операции загрузки, когда обнаружена проблема, которая может привести к потере точности данных или форматирования.
set_WebRequestTimeout(int32_t)Количество миллисекунд ожидания до истечения времени запроса. Значение по умолчанию — 100000 миллисекунд (100 секунд).
static Type()

Примеры

Показывает, как поддерживать условные комментарии при загрузке HTML‑документа.

auto loadOptions = System::MakeObject<Aspose::Words::Loading::HtmlLoadOptions>();

// Если значение истинно, то мы учитываем код VML при разборе загруженного документа.
loadOptions->set_SupportVml(supportVml);

// Этот документ содержит JPEG‑изображение внутри тегов "<!--[if gte vml 1]>",
// и другое PNG‑изображение внутри тегов "<![if !vml]>".
// Если установить флаг "SupportVml" в значение "true", то Aspose.Words загрузит JPEG.
// Если установить этот флаг в значение "false", то Aspose.Words загрузит только PNG.
auto doc = System::MakeObject<Aspose::Words::Document>(get_MyDir() + u"VML conditional.htm", loadOptions);

if (supportVml)
{
    ASSERT_EQ(Aspose::Words::Drawing::ImageType::Jpeg, (System::ExplicitCast<Aspose::Words::Drawing::Shape>(doc->GetChild(Aspose::Words::NodeType::Shape, 0, true)))->get_ImageData()->get_ImageType());
}
else
{
    ASSERT_EQ(Aspose::Words::Drawing::ImageType::Png, (System::ExplicitCast<Aspose::Words::Drawing::Shape>(doc->GetChild(Aspose::Words::NodeType::Shape, 0, true)))->get_ImageData()->get_ImageType());
}

См. также