Released: Aug 17, 2025

Aggiornamenti in 8.2.0

Funzionalità

• Update TOA and TA Fields - DsWord now provides APIs to work with TOA (Table of Authorities) and TA (Table of Authorities Entry) fields, making it easier to build and manage legal or reference-heavy documents programmatically.
  • The new ToaFieldOptions class enables developers to read and modify TOA field options, while the ToaPageNumberOptions class controls how page numbers are displayed. A CitationCategoryMap class has also been added to retrieve citation category names for more accurate categorization.
  • For TA fields, the new TaFieldOptions class allows reading and writing of TA field options, which define the text and page numbers or ranges for individual TOA entries. Together, these enhancements give developers full control to generate, update, and customize TOA and TA fields in Word documents.
• Get List of Template Tags Defined in the Document - DsWord now provides a new API to retrieve all template tags (placeholders such as {{CustomerName}}) defined in a Data Template. Using the DataTemplate.GetTemplateTagInfos() method, developers can obtain a list of TemplateTagInfo objects that provide details such as the tag's name, type, range, and text. This makes it easy to analyze or store placeholder information for reporting, data validation, or role-based permissions.
• Access Template Tags and Locations in the Exported PDF - When exporting a DsWord document to PDF, you can now mark template tag locations for accessibility, validation, or review. By setting WordLayoutSettings.MarkTemplateTagAreas = true, DsWord records the positions of template tags during layout. Developers can then use the PdfOutputSettings.MarkupTemplateTags delegate to add custom markup, such as PDF annotations, to highlight these tags on each page.
• Method GetTemplateTagInfos has been added to GrapeCity.Documents.Word.Templates.DataTemplate: Gets the list of TemplateTagInfo objects in the document.
• Enum TemplateTagType has been added to GrapeCity.Documents.Word.Templates: Specifies the type of a template tag.
• Class TemplateTagInfo has been added to GrapeCity.Documents.Word.Templates: Represents information about a template tag.
• Property MarkTemplateTagAreas has been added to GrapeCity.Documents.Word.Layout.DocumentPaginator: Indicates whether to mark the locations of named template tags during the layout process.
• Class TemplateTagAreas has been added to GrapeCity.Documents.Word.Layout: Represents the locations of a template tag on a page.
• Delegate MarkupTemplateTagsDelegate has been added to GrapeCity.Documents.Word.Layout: Defines a method that adds custom markup to template tags that appear on a PDF page.
• Property MarkupTemplateTags has been added to GrapeCity.Documents.Word.Layout.PdfOutputSettings: Specifies a method to be executed for each PDF page during export, allowing custom markup to be added to template tags on the page.
• Class ToaFieldOptions has been added to GrapeCity.Documents.Word.Fields: Represents options for configuring a Table of Authorities (TOA) field.
• Class ToaPageNumberOptions has been added to GrapeCity.Documents.Word.Fields: Represents options that control how page numbers are displayed in the result of a Table of Authorities (TOA) field.
• Class CitationCategoryMap has been added to GrapeCity.Documents.Word.Fields: Represents a mapping of category names for TA (Table of Authorities Entry) and TOA (Table of Authorities) fields.
• Class TaFieldOptions has been added to GrapeCity.Documents.Word.Fields: Represents options for configuring a TA (Table of Authorities) field.
• Property Hyphenation in GrapeCity.Documents.Word.ParagraphFormat is now obsolete. Use SuppressAutoHyphens instead.

Correzioni

• Fixed an issue where loading and saving a document using GrapeCity.Documents.Word.GcWordDocument could alter the indentation of some elements if certain rarely used formatting properties were present.