GroupDocs.Annotation for .NET 18.12 Release Notes

Major Features

Below is the list of most notable changes in release of GroupDocs.Annotation for .NET 18.12:

• Implemented export only pages that contains annotations
• Implemented export document with annotations of specific type
• Export specific range of pages of document
• Add possibility to retrieve pages without annotations
• Ensured and updated GroupDocs.Annotation code is thread-safe.
• Fixed when GetDocumentInfo method in trial mode throws exception
• Add text replacement annotation for grouped shapes for Slides.
• Fixed issue with trowing NotSupportedException exception when pass password parameter for Images.
• Fixed issue when apply annotation to empty document in Cells.

Full List of Issues Covering all Changes in this Release

Public API and Backward Incompatible Change

1. Export page range.
   To export specific pages  you should just to setup *ExportOptions *class, and then export as before.

   ExportOptions options = new ExportOptions
   {
      FirstPage = 5,
      LastPage = 8
   };
   

   Result: will be exported document pages started from page 6 and ending page 9.

   ExportOptions options = new ExportOptions
   {
      FirstPage = 4,
      LastPage = 4
   };
   

   Result: document will contain only one page with index 5.

   Note: there will be no effect if:

   • FirstPage > LastPage

   • If FirstPage or / and LastPage < 0

   • If LastPage > document pages number

2. Export only pages with annotations.
   To export only pages that contains annotations you should specify *AnnotatedPages = true *of *ExportOptions *class.

   ExportOptions options = new ExportOptions
   {
       AnnotatedPages = true
   };
   

   Result: document that contains only annotated pages.

   ExportOptions options = new ExportOptions
   {
     FirstPage = 5,
     LastPage = 8,
     AnnotatedPages = true
   };
   

   Result: A document that contains only annotated pages inside this page range. If there are not annotated pages, then the document will contains only pages from a specific range.

3. Export annotations of specific types.

   List<AnnotationType> typesToExport = new List<AnnotationType>();
   typesToExport.Add(AnnotationType.Area);
   typesToExport.Add(AnnotationType.Polyline);
   
   ExportOptions options = new ExportOptions
   {
      AnnotationTypes = typesToExport
   };
   

   Result: A document that contains only Area and Polyline annotations.

   List<AnnotationType> typesToExport = new List<AnnotationType>();
   typesToExport.Add(AnnotationType.Area);
   
   ExportOptions options = new ExportOptions
   {
     AnnotationTypes = typesToExport,
     AnnotatedPages = true
   };
   

   Result: A document that contains only annotated pages with Area annotations.

   List<AnnotationType> typesToExport = new List<AnnotationType>();
   typesToExport.Add(AnnotationType.Area);
   
   ExportOptions options = new ExportOptions
   {
      FirstPage = 5,
      LastPage = 8,
      AnnotationTypes = typesToExport,
      AnnotatedPages = true
   };
   

   Result: A document that contains only annotated pages with Area annotations inside range from 5th to 8th page. If no Area annotation inside this range, then document just contains pages from 5 to 8.