Aspose::Words::Saving::HtmlSaveOptions::get_ImagesFolder method

HtmlSaveOptions::get_ImagesFolder method

Specifies the physical folder where images are saved when exporting a document to HTML format. Default is an empty string.

System::String Aspose::Words::Saving::HtmlSaveOptions::get_ImagesFolder() const

Remarks

When you save a Document in HTML format, Aspose.Words needs to save all images embedded in the document as standalone files. ImagesFolder allows you to specify where the images will be saved and ImagesFolderAlias allows to specify how the image URIs will be constructed.

If you save a document into a file and provide a file name, Aspose.Words, by default, saves the images in the same folder where the document file is saved. Use ImagesFolder to override this behavior.

If you save a document into a stream, Aspose.Words does not have a folder where to save the images, but still needs to save the images somewhere. In this case, you need to specify an accessible folder in the ImagesFolder property or provide custom streams via the ImageSavingCallback event handler.

If the folder specified by ImagesFolder doesn’t exist, it will be created automatically.

ResourceFolder is another way to specify a folder where images should be saved.

Examples

Shows how to specify the folder for storing linked images after saving to .html.

auto doc = MakeObject<Document>(MyDir + u"Rendering.docx");

String imagesDir = System::IO::Path::Combine(ArtifactsDir, u"SaveHtmlWithOptions");

if (System::IO::Directory::Exists(imagesDir))
{
    System::IO::Directory::Delete(imagesDir, true);
}

System::IO::Directory::CreateDirectory_(imagesDir);

// Set an option to export form fields as plain text instead of HTML input elements.
auto options = MakeObject<HtmlSaveOptions>(SaveFormat::Html);
options->set_ExportTextInputFormFieldAsText(true);
options->set_ImagesFolder(imagesDir);

doc->Save(ArtifactsDir + u"HtmlSaveOptions.SaveHtmlWithOptions.html", options);

See Also

Aspose::Words::Saving::HtmlSaveOptions::get_ImageSavingCallback method Aspose::Words::Saving::HtmlSaveOptions::get_ImagesFolderAlias method