Released: Aug 18, 2025
8.2.0 中的更新
特性
Document Solutions for Excel 8.2.0
- Added support for new Excel functions GROUPBY, PIVOTBY, and PERCENTOF.
- Introduced the Evaluate2 API to return spilled values from dynamic array formulas.
- Added the ability to get and set Alternative text for shapes.
- Enabled setting chart sheet zoom to "Fit to Selection".
- Custom functions can now accept error parameters.
- Added support for the new Excel formula TRIMRANGE.
- Enabled retrieval of sheet count and names for GanttSheets from SJS files.
- Expanded the ShapeType enum with new types.
- Improved the performance of template expansion when the data source is ITableDataSource and the ExpansionType is list mode.
- Added support for Eta-Reduced Lambda.
- Added support for Excel-like worksheet background images with full compatibility for SpreadJS SJS/SSJSON file formats. Using the IWorksheet.BackgroundPicture interface, developers can retrieve background images when they are stored in Base64 format and export them to PDF with the PrintBackgroundPicture = true option.
Document Solutions for Imaging 8.2.0
- Added support for the PreviewPrintEmbedding and EditableEmbedding flags in the GrapeCity.Documents.Text.Font.Flags property.
- Introduced three new read-only string properties in the GrapeCity.Documents.Text.Font class: CopyrightNotice, LicenseDescription, and LicenseInfoURL.
Document Solutions Image Viewer 8.2.0
- Text and Object Tool - DsImageViewer now includes a new Text and Object tool on the main toolbar, enabling users to quickly insert and customize predefined objects such as shapes, text, and images. When selected, it opens a secondary toolbar for choosing object types and a properties panel where users can adjust settings for the selected object.
- The secondary toolbar supports inserting Text boxes, Rectangles, Lines, Arrows, Ellipses, Brackets, and Images. Each object includes configurable properties such as font, size, color, opacity, line styles, rotation, and more. For example, lines support start and end cap styles like arrows, circles, diamonds, and stars, while images allow options such as border radius, fill color, and aspect ratio control.
Document Solutions for PDF 8.2.0
- AI-Powered PDF Processing - This release introduces a powerful new package, DsPdfAI, designed to showcase how Document Solutions for PDF can integrate with AI services to enhance PDF document workflows. This feature allows developers to leverage OpenAI or Azure OpenAI to generate summaries, create outline trees, and extract structured tables data directly from PDFs.
- Supported Scenarios - Currently, DsPdfAI supports the following three AI-driven PDF processing capabilities:
- Generate a Document Summary - Quickly produce short or long summaries of any PDF document.
- Programmatically Generate a PDF Document Summary using DsPdfAI in C# or VB.
- Build a Document Outline Tree - Automatically generate a structured table of contents, complete with nested outline levels.
- Automatically generate a structured table of contents using AI capabilities included in a .NET PDF API.
- Extract Tables from a Document - Use natural language prompts to identify and extract tabular data from a PDF.
- Extract Tables from a PDF using PDF API AI Capabilities.
- These features are built on top of the OpenAI Chat API, with options to connect either via the official OpenAI .NET client library or the Azure OpenAI service.
- API Overview - The new package introduces two main classes, both inheriting from a shared base class for core functionality:
- OpenAIDocumentAssistant - Connects to the OpenAI REST API using the official .NET client library.
- AzureOpenAIDocumentAssistant - Connects to Azure OpenAI services using the Azure.AI.OpenAI package.
- Both derive from OpenAIDocumentAssistantBase, which implements the logic for extracting text via Page.GetText() and sending content to the AI service for processing. The pageRange parameter allows developers to limit requests to specific sections of a PDF.
- Platforms Supported:
- OpenAI REST API (via the official .NET client).
- Azure OpenAI Service (via the Azure.AI.OpenAI package).
Document Solutions PDF Viewer 8.2.0
- DsPdfViewer.wasm Now Supports Export to SVG - In this release, the WebAssembly implementation of DsPdfViewer now supports saving and exporting a loaded-in PDF file to SVG format, which will be included within a .zip file after exporting to SVG format.
- Redesigned Toolbar and Navigation for Better Usability - With this release, DsPdfViewer introduces a redesigned toolbar and navigation system to improve usability, consistency, and customization across viewing and editing modes. These changes ensure that the most frequently used actions are easier to access, while still allowing backward compatibility for users who prefer the legacy layout.
- Toolbar Layout Improvements - The toolbar has been restructured to prioritize commonly used actions and streamline the interface. If the old layout/behavior is desired, it can be restored by following the commands shown in the CHANGELOG.md file included with the release.
- New Default Order
- View mode: Open → Save → Print → Search (moved Open to the front for faster access).
- Edit mode: Added Open before Save.
- Removed from Default Toolbar
- Full Screen.
- Themes.
- Extract Table (moved to the side panel).
- Form Filler Button
- Now appears only in the mobile toolbar by default.
- Optimized for smaller screens like tablets and phones, where form-filling is common.
- Side Panel Enhancements - The side panel has been updated for a more intuitive workflow, with a new default order and icon updates.
- New Default Order:
- Document List → Shared Documents → Search → Thumbnails → Outline → Structure Tree → Articles → Layers → Attachments → Extract Table.
- Updated Extract Table Icon - Now displays a table with a right-pointing arrow for clarity.
- Navigation Controls & Keyboard Support - Navigation is now more compact, customizable, and accessible.
- Visual Updates
- Compact page navigation input.
- First/Last page buttons hidden by default.
- Improved page counter display logic.
- Keyboard Shortcuts (when page input is focused):
- ← / → : Navigate pages (context-aware).
- ↑ / ↓ : Force page navigation.
- PageUp / PageDown : Jump to previous/next page.
- Home / End : Jump to first/last page.
- Enter : Submit manual entry.
- Escape : Cancel input.
- Ctrl + Click on page arrows : Jump to first/last page.
- New Semantic CSS Classes:
- .gc-btn.go-to-first.
- .gc-btn.go-to-last.
- .current-page-input.
- .gcv-page-input__text.
- Overlapping Annotations Handling (Editor Mode) - When multiple annotations overlap, users now get clearer and more precise control:
- Primary Context Menu shows actions for the topmost annotation.
- Additional Annotations Section lists other overlapping annotations below a separator.
- Clicking any listed annotation switches focus for editing.
- Context Menu & UI Standardization - To ensure consistency and professionalism, the interface now follows standardized formatting for all text elements:
- Buttons / Menu Items / Headers: Title Case.
- Tooltips: Sentence case.
- Labels: Title Case.
- Descriptions / Status Text: Sentence case.
- Placeholders: Sentence case.
- Technical Terms: Original case (e.g., PDF, URL, iOS).
- Dynamic Values:
- In Actions: Title Case → "Add {{count}} Files".
- In Descriptions: Original case → "{{count}} files processed".
- API Enhancements - Developers can now customize navigation more precisely with new configuration options.
Document Solutions for Word 8.2.0
- 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.
修补程序
Document Solutions for Excel 8.2.0
- Exporting to Excel takes unusually long when files contain multiple VLOOKUP functions.
- Font formatting changes unexpectedly after opening and saving files.
- Memory usage is excessively high when processing large-scale data with Workbook.ProcessTemplate().
- Report rendering speed is slower than expected when processing large datasets.
- Performance differs significantly between Template and setDataSource methods when rendering large lists.
- Processing templates with a large number of rows takes longer than expected and may cause memory issues in multi-threaded scenarios.
- Font formatting is inconsistent when converting SJS files to XLSX, resulting in font changes.
- Executing the toImage function on Mac and Linux triggers console errors due to unsupported fonts or emoji rendering issues.
- Freeze pane location shifts after processing files containing collapsed groups, causing incorrect frozen areas.
- Sorting order for Japanese text in Pivot Tables does not follow locale-specific rules.
- Saving certain workbooks fails with System.ArgumentOutOfRangeException due to issues in chart handling.
- Table filter buttons appear inconsistently compared to older versions, indicating lost filter information in processed templates.
Document Solutions for PDF 8.2.0
- Fixed an issue where GcPdfDocument.Page.GetText() and GcPdfDocument.Page.GetTextMap().GetText() could return different text when GcPdfDocument.RecognitionAlgorithm was Advanced (the default).
Document Solutions for Word 8.2.0
- 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.