Aspose.Words for C++ 22.11 Release Notes

/// Gets or sets a value determining whether or not to embed attachments to the PDF document.
/// Default value is <c>%false</c> and attachments are not embedded.
/// When the value is <c>%true</c> attachments are embedded to the PDF document.
/// Embedding attachments is not supported when saving to PDF/A and PDF/UA compliance.
/// <c>%false</c> value will be used automatically.
/// Embedding attachments is not supported when encryption is enabled. <c>%false</c> value
/// will be used automatically.
ASPOSE_WORDS_SHARED_API bool get_EmbedAttachments() const;
/// Setter for Aspose::Words::Saving::PdfSaveOptions::get_EmbedAttachments
ASPOSE_WORDS_SHARED_API void set_EmbedAttachments(bool value);

auto doc = System::MakeObject<Document>();

// Create a structured document tag of the Citation type.
auto sdt = System::MakeObject<StructuredDocumentTag>(doc, SdtType::Citation, MarkupLevel::Inline);

// Append to a paragraph.
auto paragraph = doc->get_FirstSection()->get_Body()->get_FirstParagraph();
paragraph->AppendChild(sdt);

// Create a Citation field.
auto builder = System::MakeObject<DocumentBuilder>(doc);
builder->MoveToParagraph(0, -1);
builder->InsertField(u"CITATION Ath22 \\l 1033 ", u"(Author1, 2022)");

// Move the field to the structured document tag.
while (sdt->get_NextSibling() != nullptr)
sdt->AppendChild(sdt->get_NextSibling());

doc->Save(u"output.docx");

void OpenDoc(System::String fileName)
{
    try
    {
        System::SharedPtr<Aspose::Words::Document> doc = System::MakeObject<Aspose::Words::Document>(fileName);
    }
    catch (Aspose::Words::UnsupportedFileFormatException& e)
    {
        System::Console::WriteLine(u"{0} is opened with exception", fileName);
        return;
    }

    System::Console::WriteLine(u"{0} is opened successfully", fileName);
}

int main(int argc, char** argv)
{
    System::String content(u'\x0000', 20);

    System::IO::File::WriteAllText(u"a.doc", content);
    OpenDoc(u"a.doc");
    
    System::IO::File::WriteAllText(u"b.docx", content);
    OpenDoc(u"b.docx");
}

// The code produces the following output:
// a.doc is opened successfully
// b.docx is opened with exception

/// Gets <see cref="Aspose::Words::Fields::IFieldUpdatingProgressCallback">IFieldUpdatingProgressCallback</see> implementation.
ASPOSE_WORDS_SHARED_API const System::SharedPtr<Aspose::Words::Fields::IFieldUpdatingProgressCallback>& get_FieldUpdatingProgressCallback() const;

/// Sets <see cref="Aspose::Words::Fields::IFieldUpdatingProgressCallback">IFieldUpdatingProgressCallback</see> implementation.
void set_FieldUpdatingProgressCallback(const System::SharedPtr<Aspose::Words::Fields::IFieldUpdatingProgressCallback>& value);

/// Interface IFieldUpdatingProgressCallback
/// Implement this interface if you want to track field updating progress.
class ASPOSE_WORDS_SHARED_CLASS IFieldUpdatingProgressCallback : public System::Object
{
    typedef IFieldUpdatingProgressCallback ThisType;
    typedef System::Object BaseType;
    typedef ::System::BaseTypesInfo<BaseType> ThisTypeBaseTypesInfo;
    ASPOSE_WORDS_SHARED_RTTI_INFO_DECL();

public:
    /// A user defined method that is called when updating progress is changed.
    virtual void Notify(System::SharedPtr<Aspose::Words::Fields::FieldUpdatingProgressArgs> args) = 0;
};

/// Provides data for the field updating progress event.
class ASPOSE_WORDS_SHARED_CLASS FieldUpdatingProgressArgs final : public System::Object
{
    typedef FieldUpdatingProgressArgs ThisType;
    typedef System::Object BaseType;
    typedef ::System::BaseTypesInfo<BaseType> ThisTypeBaseTypesInfo;
    ASPOSE_WORDS_SHARED_RTTI_INFO_DECL();

public:
    /// Gets the total fields count to be updated.
    ASPOSE_WORDS_SHARED_API int32_t get_TotalFieldsCount() const;

    /// Gets the number of updated fields.
    ASPOSE_WORDS_SHARED_API int32_t get_UpdatedFieldsCount() const;
    
    /// Gets a value indicating whether field updating is completed.
    ASPOSE_WORDS_SHARED_API bool get_UpdateCompleted() const;
};

auto document = System::MakeObject<Document>(filename);
document->get_FieldOptions()->set_FieldUpdatingProgressCallback(System::MakeObject<FieldUpdatingProgressCallback>());
document->UpdateFields();

class FieldUpdatingProgressCallback : public IFieldUpdatingProgressCallback
{
    virtual void Notify(System::SharedPtr<Aspose::Words::Fields::FieldUpdatingProgressArgs> args) override
    {
        System::Console::WriteLine(u"{0}/{1}", args->get_UpdateCompleted(), args->get_TotalFieldsCount());
    }
}

/// Gets or sets a value determining whether or not to cache graphics placed in document's background.
/// Default value is <c>%true</c> and background graphics are written to the PDF document as an xObject.
/// When the value is <c>%false</c> background graphics are not cached.
/// Some shapes are not supported for caching(shapes with fields, bookmarks, HRefs).
/// Document background graphic is various shapes, charts, images placed in the footer or header,
/// well as background and border of a page.
bool get_CacheBackgroundGraphics() const;
/// Setter for Aspose::Words::Saving::PdfSaveOptions::get_CacheBackgroundGraphics
void set_CacheBackgroundGraphics(bool value);

auto doc = System::MakeObject<Document>(filename);
auto saveOptions = System::MakeObject<PdfSaveOptions>();
saveOptions->set_CacheBackgroundGraphics(true);
doc->Save(outputFileName, saveOptions);