This documentation was last revised for 2011 v2. Enhancements and changes were made to ComponentOne Reports for WinForms in this release.
New Features
The following improvements were made to the C1MultiDocument control in the 2011 v2 release of ComponentOne Reports for WinForms:
• New C1MultiDocument Features
The following improvements were made to the C1MultiDocument control in the 2011 v2 release of ComponentOne Reports for WinForms:
o In addition to C1PrintDocument, now C1Report and C1RdlReport objects can be added to a C1MultiDocument. If any reports within a multi-document require parameters, they are requested prior to generating the multi-document.
Outline support was added to C1MultiDocument. A collection of outline nodes specific to the multi-document may be specified via the Outlines property. The resulting outline (such as for the preview) is built as a combination of outline nodes in that collection and outline nodes in the contained documents. See C1MultiDocument Outlines for details. o
o The ItemLoaded event was added to C1MultiDocument. This event occurs when the report or document represented by an item is loaded into memory (deserialized) prior to generation, but after processing of any parameters. This event allows programmatically adjusting the properties of the report or document before it is generated. For instance, the data source of a C1Report may be assigned here.
Improvements and Changes
The following improvements were made in the 2011 v2 release of ComponentOne Reports for WinForms:
• New Japanese translations were added.
• The controls provides better diagnostics when trying to open a file in unknown/unsupported format.
• In C1PrintDocument's tags input form, now an up/down spanner is used instead of a drop-down calendar for DateTime input if the format is time.
• The UpcE barcode format is now supported
• A default name ("C1Document") is assigned to a print job when a document without a user specified name is printed. This avoids problems when printing to Adobe Acrobat X and some other virtual printers (output file is not created)..
• Improved performance when serializing styles.
• .NET 4.0 build only: added explicit references to designer assemblies. This fixes issues when multiple versions of C1Report are installed on the same system.
• Properties defined in user types derived from C1PrintDocument, RenderObject or other C1 types are now excluded from C1D/X serialization by default. If you have your own types derived from C1 types, and are sure that you need those properties to be serialized, mark them with either XmlElementAttribute or XmlAttributeAttribute. (If an exception occurs during serialization, that exception now contains a Log property that might help identify the problem.)
• Removed run time-only C1PrintDocument.DocumentInto.UserData from design time property editor.
• When deserializing very large C1PrintDocument objects, use a temporary disk file instead of memory. This helps avoid out of memory exceptions in certain scenarios, such as when previewing a large C1MultiDocument.
New Members
New members were added to Reports for Winforms in the 2011 v2 release.
|
Class |
Member |
Description |
|
ClearGeneratedPages method |
This method allows clearing generated pages and other data without deleting the content of a document or report, so that it can be regenerated. | |
|
IsGenerating property |
Indicates whether the document is currently being generated. | |
|
ItemAdded event |
Occurs when a C1MultiDocumentItem has been added to the current multi-document's Items collection. | |
|
ItemAdding event |
Occurs when a C1MultiDocumentItem is about to be added to the current multi-document's Items collection | |
|
ItemGenerating event |
Occurs when the generation of a document or report associated with a C1MultiDocumentItem is about to start. | |
|
ItemLoaded event |
Occurs when the report or document represented by an item is loaded into memory (deserialized) prior to generation, but after processing of any parameters. This event allows programmatically adjusting the properties of the report or document before it is generated. For instance, the data source of a C1Report may be assigned here. | |
|
ItemRemoved event |
Occurs when a C1MultiDocumentItem has been removed from the current multi-document's Items collection. | |
|
ItemRemoving event |
Occurs when a C1MultiDocumentItem is about to be removed from the current multi-document's Items collection. | |
|
ItemsClear event |
Occurs when the current multi-document's Items collection has been cleared. | |
|
ItemsClearing event |
Occurs when the current multi-document's Items collection is about to be cleared. | |
|
MakeOutlines method |
Builds the outline tree for the current multi-document, merging the multi-document's own outlines (Outlines) and outline trees of documents and reports contained within the multi-document. | |
|
Outlines property |
Gets the OutlineNodeCollection containing outline nodes specified for the multi-document. Note that this collection does not include outlines of documents and reports contained within this multi-document. Use the MakeOutlines method to build the complete outline tree for the multi-document. | |
|
IsGenerating property |
Indicates whether the document is currently being generated. | |
|
UserData property |
Gets or sets arbitrary data associated with the current document. | |
|
OutlineNode property |
Gets or sets the outline node representing the current item in Outlines. | |
|
Outlines property |
Gets the collection of outlines defined on the document or report represented by the current multi-document item. | |
|
Remove method |
Removes an item from the current collection. | |
|
ClearGeneratedPages method |
This method allows clearing generated pages and other data without deleting the content of a document or report, so that it can be regenerated. | |
|
HasEditableTags method |
Checks whether the document contains any tags that can be entered or changed in the tags input dialog box. Note that this method does NOT check the value of the ShowTagsInputDialog property. | |
|
ClearGeneratedPages method |
This method allows clearing generated pages and other data without deleting the content of a document or report, so that it can be regenerated. | |
|
ClearGeneratedPages method |
This method allows clearing generated pages and other data without deleting the content of a document or report, so that it can be regenerated. | |
|
EmfType property |
Gets or sets the type of metafiles created by the current document. |
Tip: A version
history containing a list of new features, improvements, fixes, and changes for
each product is available on the ComponentOne Web site at http://helpcentral.componentone.com/VersionHistory.aspx.
|
