Though WordWriter Version 4 is for the most part backwards compatible with applications written for WordWriter Version 3, there are a number of changes which must be considered when upgrading from Version 3 to Version 4:

Installing OfficeWriter Version 4

To upgrade WordWriter Version 3 to WordWriter Version 4, you should first uninstall OfficeWriter Version 3.

Unlike OfficeWriter v3, there are no .NET 1.0 DLLs available for OfficeWriter v4. Before running the OfficeWriter Version 4 installer, you must make sure that you have the .NET runtime 2.0 or higher installed on your server. However, OfficeWriter v4 no longer requires the J# redistributable, so you will not need to install or upgrade J# to install OfficeWriter v4.

To install OfficeWriter v4, follow the installation instructions found in the Installing WordWriter documentation. Remember to use an OfficeWriter v4 or WordWriter v4 license key, as OfficeWriter license keys are version-specific, and an OfficeWriter v3/WordWriter v3 license key will not register correctly with OfficeWriter v4/WordWriter v4.

Changes in WordWriter Properties, Methods, and Enumerations

A number of minor changes were made to WordWriter properties and methods in the shift from J# source code to pure C#.

The following is a list of properties that have been changed to methods in SoftArtisans WordWriter v4. If you use any of these properties in your application, you will need to replace them with the appropriate method calls.

WordWriter v3 Property

WordWriter v4 Method(s)

Document.Bookmark

Document.GetBookmark(String)

DocumentProperties.Property

DocumentProperties.GetProperty(String)
DocumentProperties.GetProperty(DocumentProperties.BuiltInProperty)
DocumentProperties.SetProperty(String, Object)
DocumentProperties.SetProperty(DocumentProperties.BuiltInProperty, Object)

Element.Elements

Element.GetElements(Element.Type)

ParagraphFormatting.Border

ParagraphFormatting.GetBorder(Border.Location)

ParagraphFormatting.Indent

ParagraphFormatting.GetIndent(ParagraphFormatting.IndentLocation)
ParagraphFormatting.SetIndent(Int32, ParagraphFormatting.IndentLocation)

Section.Border

Section.GetBorder(Border.Location)

Section.Footer

Section.GetFooter(Section.HeaderFooterType)

Section.Header

Section.GetHeader(Section.HeaderFooterType)

Table.PreferredColumnWidth

Table.GetPreferredColumnWidth(Int32)
Table.SetPreferredColumnWidth(Int32, Int32)

Table.PreferredColumnWidthUnits

Table.GetPreferredColumnWidthUnits(Int32)
Table.SetPreferredColumnWidthUnits(Int32, TableCell.WidthUnits)

Table.RowHeight

Table.GetRowHeight(Int32)
Table.SetRowHeight(Int32, Int32)

Table.RowHeightExact

Table.GetRowHeightExact(Int32)
Table.SetRowHeightExact(Int32, Boolean)

TableCell.Border

TableCell.GetBorder(Border.Location)

TableCell.Padding

TableCell.GetPadding(TableCell.Location)
TableCell.SetPadding(TableCell.Location, Int32)

TableFormatting.DefaultBorder

TableFormatting.GetDefaultBorder(Border.Location)

TableFormatting.DefaultPadding

TableFormatting.GetDefaultPadding(TableCell.Location)
TableFormatting.SetDefaultPadding(TableCell.Location, Int32)

The following is a property that has been changed in SoftArtisans WordWriter v4. If you use this property in your application, you will need to replace it with the new property.

WordWriter v3 Property

WordWriter v4 Property

Position.Position

Position.PositionValue