GrapeCity.Documents.Pdf 6.2.0

• .NETFramework 4.6.1

  • GrapeCity.Documents.Imaging (= 6.2.0)
  • Portable.BouncyCastle (>= 1.8.2)

• .NETStandard 2.0

  • GrapeCity.Documents.Imaging (= 6.2.0)
  • Portable.BouncyCastle (>= 1.8.2)

# Changes since version 6.1.5:

## Breaking Changes
- The stream that is passed to one of GcPdfDocument.Load() method overloads must be kept open while the loaded GcPdfDocument is in use.
- If using GcPdfDocument.MergeWithDocument(), the passed GcPdfDocument is effectively in use while the current document is in use. If it was loaded from a stream, that stream must be kept open too.
- Several existing collection properties can no longer be modified in place (see below). Instead, create a new instance of the collection and assign it to the property.
- WidgetAnnotation.TextFormat property removed (previously it was obsolete).
- GrapeCity.Documents.Pdf.Layers.OptionalContentOrderCollection class is now derived from PdfCollection<IPdfObject> (previously it was derived from List<object>).
- GrapeCity.Documents.Pdf.AcroForms.SignatureLockedFields.FieldNames property type changed from ObservableCollection<string> to IEnumerable<string>. To change the value, create a new instance of the collection and assign it to the property.
- GrapeCity.Documents.Pdf.SoundObject.EncodingFormat property type changed from string to IPdfName.
- GrapeCity.Documents.Pdf.Text.CMap.CMap class renamed to CMapTable, CMapBase class removed.
- GrapeCity.Documents.Pdf.Actions.ActionHide.LinkedObjects property type changed from List<object> to LinkedObjectCollection. To change the value, create a new instance of the collection and assign it to the property.
- GrapeCity.Documents.Pdf.Actions.ActionFieldsBase.FieldNames property changed from List<string> FieldNames { get; } to IList<IFieldDef> Fields { get; }.
- Properties ViewerPreferences.PageMode and ViewerPreferences.PageLayout marked as obsolete, corresponding properties are now available directly on GcPdfDocument: GcPdfDocument.PageMode and GcPdfDocument.PageLayout.
- Property WidgetAnnotation.TriggerEvents.Activate marked as obsolete, corresponding property is now available directly on WidgetAnnotation: WidgetAnnotation.Activate.
- GrapeCity.Documents.Pdf.Annotations.PolygonAnnotationBase.Points property type changed from IList<PointF> to IReadOnlyList<PointF>. To change the value, create a new instance of the collection and assign it to the property.
- GrapeCity.Documents.Pdf.Annotations.ImageScale class is now derived from GrapeCity.Documents.Pdf.Wrappers.PdfDictWrapper (previously it was derived from NotifyObject).
- GrapeCity.Documents.Pdf.Annotations.ButtonAppearance.Image property type changed from object to IXObject. IXObject is a common interface for FormXObject and PdfImageObjectBase. An IImage can be assigned to this property using PdfImageHandler: doc.ImageHandlers.GetImageHandler(someBitmap).
- GrapeCity.Documents.Pdf.Annotations.InkAnnotation.Paths property type changed from ObservableCollection<PointF[]> to IReadOnlyList<IReadOnlyLust<PointF>>. To change the value, create a new instance of the collection and assign it to the property.
- GrapeCity.Documents.Pdf.Annotations.TextMarkupAnnotation.Area property type changed from ObservableCollection<Quadrilateral> to IReadOnlyList<Quadrilateral>. To change the value, create a new instance of the collection and assign it to the property.
- GrapeCity.Documents.Pdf.Annotations.RedactAnnotation.Area property type changed from ObservableCollection<Quadrilateral> to IReadOnlyList<Quadrilateral>. To change the value, create a new instance of the collection and assign it to the property.
- Now even if an annotation belongs to several pages, its vertical coordinate is converted to the GcPdf top/left coordinate system using the media box of the first page in the annotation's Pages collection. The AnnotationBase.PdfRect property provides access to native PDF coordinates.
- GrapeCity.Documents.Pdf.Structure.StructElement.ID property type changed from IList<byte> to IPdfString.
- PdfIndirectSerializableObject class was removed, the GrapeCity.Documents.Pdf.Wrappers.PdfWrapperBase and its descendants can be used instead.
- PdfDict class is now derived from Dictionary<PdfName, IPdfObject> (previously it was derived from Dictionary<string, object>). Instead of using a string directly, use new PdfName(string) instead.
- GcPdfDocument.NamedDestinations property type changed from IDictionary<string, Destination> to IDictionary<string, IDestination>. The IDestination interface is common to Destination and ActionGoTo classes.
- PdfLang type was removed, all properties that previously had that type are now of the type string.
- ICCProfile.IsSame() method was removed.
- GrapeCity.Documents.Pdf.Annotations.UnknownAnnotation.Subtype property type changed from string to PdfName.
- PdfDictWrapperObject class was removed, use PdfDictWrapper instead.
- CheckBoxField.ValueObj property behavior changed, now it returns Boolean true if all widgets of the CheckBoxField use the same name for appearance stream used to display a checked state. Previously it returned "Off" if field was unchecked, or the name of the checked appearance stream. Use PdfValue property to get the PdfName used to hold value.

## Changed
- GcPdfDocument.Load() method now implements lazy loading of PDF objects. This provides several advantages, including: improved compatibility with PDFs produced by various vendors, custom content unknown to GcPdf is preserved as is, improved average load speed. (DOC-1781)

## Added
- Ability to open/modify (with limitations) password a protected PDF without specifying the password, see GcPdfDocument.Load(stream, DecryptionOptions) overload. (DOC-3410)
- Helper methods to TextBoxField, ComboBoxField and CombTextField: SetPercentFormat(), SetPercentValue(), SetNumberFormat(), SetNumberValue(), SetDateFormat(), SetDateValue(), SetTimeFormat(), SetTimeValue(), SetSpecialFormat(), SetSpecialFormatValue(). (DOC-5076)
- Ability to generate custom time-stamp tokens. The new ITimeStampGenerator interface can be implemented by user and assigned to SignatureProperties.TimeStamp and TimeStampProperties.TimeStamp.

## Fixed
- Several issues related to errors when opening existing PDFs. (DOC-2111, DOC-3923, DOC-4096, DOC-5461)