ComponentOne Reports for WPF
C1.C1Report Namespace / C1Report Class
Properties Methods Events

In This Topic
    C1Report Class Members
    In This Topic

    The following tables list the members exposed by C1Report.

    Public Constructors
     NameDescription
    Public ConstructorC1Report ConstructorInitializes a new instance of the C1Report component.  
    Top
    Public Properties
     NameDescription
    Public PropertyColorizeHyperlinksGets or sets a value indicating whether hyperlinks in the report are colorized automatically.

    The default is false (which is compatible with older versions of C1Report).

     
    Public PropertyCompatibilityOptionsGets the CompatibilityOptions object which determines compatibility with previous versions of C1Report.  
    Public PropertyCreationDeviceGets or sets the type of device that is used to provide reference graphics when generating the report. If this property is C1.C1Preview.MeasurementDeviceEnum.Printer (which is the default), CreationPrinterName specifies the printer.  
    Public PropertyCreationPrinterNameGets or sets the name of the printer that is used to provide reference graphics when generating the report.

    This property is only used if CreationDevice is set to C1.C1Preview.MeasurementDeviceEnum.Printer.

    Set this property to null to select the reference printer automatically.

     
    Public PropertyDataSourceGets a reference to the report's DataSource object.  
    Public Propertystatic (Shared in Visual Basic)DefaultRightToLeftGets or sets the value used as the default for the RightToLeft property.  
    Public PropertyDoEventsSpecifies whether the control should handle Windows messages while rendering reports.  
    Public PropertyEmfTypeGets or sets the type of metafiles created by the current report. The default is System.Drawing.Imaging.EmfType.EmfOnly.  
    Public PropertyExposeScriptObjectsSpecifies whether script objects added with the AddScriptObject(String,Object) method should be exposed to subreports.  
    Public PropertyFontGets or sets the default font for new fields.  
    Public PropertyFontProcessingOptionsGets the FontProcessingOptions object which determines how font substitution and embedding are handled when the report generates.  
    Public PropertyGrowShrinkModeGets or sets the method used to process CanGrow/CanShrink fields.  
    Public PropertyIgnoreScriptErrorsSpecifies whether the component should ignore script errors by default.  
    Public PropertyLayoutGets a reference to the report's Layout object.  
    Public PropertyMaxPagesGets or sets the maximum number of pages allowed for a report.  
    Public PropertyOnCloseGets or sets the VBScript that is executed when the report finishes rendering.  
    Public PropertyOnErrorGets or sets the VBScript that is executed when an error occurs.  
    Public PropertyOnNoDataGets or sets the VBScript that is executed when the report starts rendering and its source recordset is empty.  
    Public PropertyOnOpenGets or sets the VBScript that is executed when the report starts rendering.  
    Public PropertyOnPageGets or sets the VBScript that is executed when a new page is created.  
    Public PropertyOutlineRootLevelGets or sets the starting outline level for the groups in this report.  
    Public PropertyPageRenderingModeGets or sets a value specifying the page rendering mode to use when generating the report. Use PageRenderingMode.AsMetafiles for very large reports which run out of memory when using the default mode.  
    Public PropertyRecordsPerPageGets or sets the number of detail records to render per page or group.  
    Public PropertyReportInfoGets or sets a ReportInfo object containing report metadata.  
    Public PropertyReportNameGets or sets the name of the report (used with the Load method).  
    Public PropertyRightToLeftGets or sets a value indicating whether the fields of the report should use right-to-left rules for rendering text.

    If null (which is the default), the value of the static property DefaultRightToLeft is used.

    This value may be overridden by individual fields.

     
    Public PropertyTagGets or sets extra data needed by the calling program.  
    Public PropertyUseGdiPlusTextRenderingGets or sets a value indicating whether all text in the current report should be rendered using GDI+ text API.

    The default value is false.

     
    Top
    Public Methods
     NameDescription
    Public MethodAddScriptObjectOverloaded. Adds an object to the report's script context.  
    Public MethodBeginInitSignals the object that initialization is starting.  
    Public MethodClearClears the current report.  
    Public MethodClearGeneratedPagesClears the pages and other info created during report generation. This method does not clear the report definition though.  
    Public MethodCopyFromCopies a report definition from another C1Report component.  
    Public MethodCreateObjRef (Inherited from System.MarshalByRefObject)
    Public MethodDispose() (Inherited from System.ComponentModel.Component)
    Public MethodEndInitSignals the object that initialization is complete.  
    Public MethodEvaluateOverloaded. Evaluates a VBScript expression in the current report context.  
    Public MethodExecuteOverloaded. Executes a VBScript statement in the current report context.  
    Public MethodGetLifetimeService (Inherited from System.MarshalByRefObject)
    Public MethodGetPageCountGets the total number of pages in the generated report. Use this method rather than Count on the PageImages collection as accessing that property creates images for all pages at once and thus can exhaust system resources.  
    Public MethodGetPageImageGets a metafile representing the specified page. Use this method rather than the PageImages collection as accessing that property creates images for all pages at once and thus can exhaust system resources.  
    Public MethodGetPageImagesEnumerates page images (represented by metafiles) of the generated report. Using this method in a "foreach" loop allows to iterate over all pages of a large report without exhausting system resources. This approach is preferable to PageImages property that creates images for all pages and can consume a large amount of resources.  
    Public MethodGetReportInfoOverloaded. Gets a list of reports available in an XML report definition file.  
    Public Methodstatic (Shared in Visual Basic)GetReportListOverloaded. Gets a list of reports available in an XML report definition file.  
    Public MethodInitializeLifetimeService (Inherited from System.MarshalByRefObject)
    Public MethodLoadOverloaded. Loads a report from an XML report definition in stream.  
    Public MethodParseExpressionParses a VBScript expression in the current report context.  
    Public MethodParseStatementOverloaded. Parses a VBScript statement in the current report context.  
    Public MethodPrintOverloaded. Prints the current report with default printer settings, not showing the print progress dialog.  
    Public MethodPrintDialogOverloaded. Shows the standard print dialog, allowing the user to print the current document.  
    Public MethodRenderRenders the report into an internal collection of images.  
    Public MethodRenderToFileRenders the report into a file.  
    Public MethodRenderToFilterRenders the report into an ExportFilter object.  
    Public MethodRenderToStreamOverloaded. Renders the report into a System.IO.Stream object.  
    Public MethodSaveOverloaded. Saves the current report definition to a file.  
    Public MethodSetCreationDeviceAssigns specified values to the CreationDevice and CreationPrinterName properties. Using this method is more efficient than setting the two properties individually.  
    Public MethodToString (Inherited from System.ComponentModel.Component)
    Top
    Public Events
     NameDescription
    Public EventAddOutlineEntryFired before the control adds an outline entry to the report.  
    Public EventEndPageFired when the control finishes rendering each page.  
    Public EventEndReportFired when the control finishes rendering the report.  
    Public EventEndSectionFired when the control finishes rendering each Section.  
    Public EventInitializeParametersDialogFired before the control displays the Report Parameters dialog.  
    Public EventLongOperationOccurs periodically during document generation. Allows to provide progress indication and the ability to cancel generation to the user.  
    Public EventNoDataFired when the control starts rendering a report and the data source is empty.  
    Public EventPrintSectionFired before each Section is printed (after it has been formatted.)  
    Public EventReportErrorFired when an error occurs while rendering a report.  
    Public EventStartPageFired when the control starts rendering each page.  
    Public EventStartReportFired when the control starts rendering the report, before it opens the source recordset.  
    Public EventStartSectionFired before each Section is formatted.  
    Top
    See Also

    Reference

    C1Report Class
    C1.C1Report Namespace