Reports for WinForms | ComponentOne
C1.C1Report.4 Assembly / 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 ConstructorInitializes a new instance of the C1Report component.  
    Top
    Public Properties
     NameDescription
    Public PropertyGets the actual measurement device which was used to generate the report. This device can differ from the one specified by CreationDevice, for example if CreationDevice was set to C1.C1Preview.MeasurementDeviceEnum.Printer but the current system has no printers installed.  
    Public PropertyGets the name of the actual measurement printer which was used to generate the report. This can differ from the name specified by CreationPrinterName, for example if the report was rendered on a system with no such printer.  
    Public PropertyGets the actual right-to-left value that is being used. The value is obtained using the following rules:
    1. If RightToLeft is not null, then that value is used.
    2. If the current report is a sub-report, then ActualRightToLeft of the owner subreport field is used.
    3. Else the value of C1FlexReport.DefaultRightToLeft static property is used.
     
    Public PropertyGets the height of the remaining area available for sections on the current page. This property can only be used while the report is being rendered (i.e. when IsBusy is true), at other times a value of -1 is returned. Note that if used in OnPrint/OnFormat scripts, this value does NOT yet account for the current section.  
    Public PropertyGets a C1.C1Preview.C1PrintDocument object that represents content of the report. Note that getting this property causes the report to render if it has not rendered yet.  
    Public PropertySpecifies whether to cancel generation of the current report.  
    Public PropertyGets 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 PropertyGets the CompatibilityOptions object which determines compatibility with previous versions of C1Report.  
    Public Property (Inherited from System.ComponentModel.Component)
    Public PropertyGets 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 PropertyGets or sets the resolution (DPI) used when generating the report.  
    Public PropertyGets or sets the System.Drawing.Graphics object to use as reference when generating the report. This Graphics is used to calculate text sizes, measure RTF text, and so on.  
    Public PropertyGets 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 PropertyGets a reference to the report's DataSource object.  
    Public Propertystatic (Shared in Visual Basic)Gets or sets the value used as the default for the RightToLeft property.  
    Public PropertyGets a System.Drawing.Printing.PrintDocument object that can be used to render the report to a printer or into a print preview control.  
    Public PropertySpecifies whether the control should handle Windows messages while rendering reports.  
    Public PropertyGets or sets the type of metafiles created by the current report. The default is System.Drawing.Imaging.EmfType.EmfOnly.  
    Public PropertySpecifies whether script objects added with the AddScriptObject(String,Object) method should be exposed to subreports.  
    Public PropertyGets the collection of Field objects in the report definition.  
    Public PropertyGets or sets the default font for new fields.  
    Public PropertyGets the FontProcessingOptions object which determines how font substitution and embedding are handled when the report generates.  
    Public PropertyIf the current report is generating (see IsBusy), gets the approximate completion ratio, from 0 (0% complete) to 1 (100% complete). If the report is currently not generating, gets 1.  
    Public PropertyGets or sets the global VBScript module. Functions and subroutines defined here (using the standard VBScript syntax) can be used in other scripts in the current report like standard VBScript functions.  
    Public PropertyGets a collection with all the groups in the report.  
    Public PropertyGets or sets the method used to process CanGrow/CanShrink fields.  
    Public PropertySpecifies whether the component should ignore script errors by default.  
    Public PropertyGets a value that determines whether a report is currently being generated.  
    Public PropertyGets or sets the position of the first label on a partially used sheet.  
    Public PropertyGets a reference to the report's Layout object.  
    Public PropertyGets or sets the maximum number of pages allowed for a report.  
    Public PropertyGets or sets the VBScript that is executed when the report finishes rendering.  
    Public PropertyGets or sets the VBScript that is executed when an error occurs.  
    Public PropertyGets or sets the VBScript that is executed when the report starts rendering and its source recordset is empty.  
    Public PropertyGets or sets the VBScript that is executed when the report starts rendering.  
    Public PropertyGets or sets the VBScript that is executed when a new page is created.  
    Public PropertyGets or sets the starting outline level for the groups in this report.  
    Public PropertyGets or sets the current page number.  
    Public PropertyGets a list of System.Drawing.Imaging.Metafile objects that correspond to the pages in the report. Using this property on large reports is not recommended as it creates images for all pages at once and thus can exhaust system resources. Instead, use GetPageImages, GetPageImage and GetPageCount methods.  
    Public PropertyGets 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 PropertyGets the main report that contains this subreport (null for main reports).  
    Public PropertyGets or sets the number of detail records to render per page or group.  
    Public PropertyGets or sets an Xml string containing the complete report definition.  
    Public PropertyGets or sets a ReportInfo object containing report metadata.  
    Public PropertyGets or sets the name of the report (used with the Load method).  
    Public PropertyGets 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 PropertyGets the collection of Section objects in the report definition.  
    Public Property (Inherited from System.ComponentModel.Component)
    Public PropertyGets or sets extra data needed by the calling program.  
    Public PropertyGets or sets a value indicating whether all text in the current report should be rendered using GDI+ text API.

    The default value is false.

     
    Public PropertySpecifies whether the component should use the .NET printing support to obtain high-resolution graphics.  
    Top
    Protected Properties
    Public Methods
     NameDescription
    Public MethodOverloaded. Adds an object to the report's script context.  
    Public MethodSignals the object that initialization is starting.  
    Public MethodClears the current report.  
    Public MethodClears the pages and other info created during report generation. This method does not clear the report definition though.  
    Public MethodCopies a report definition from another C1Report component.  
    Public Method (Inherited from System.MarshalByRefObject)
    Public MethodOverloaded. Overridden. Releases the resources used by the component.  
    Public MethodSignals the object that initialization is complete.  
    Public MethodOverloaded. Evaluates a VBScript expression in the current report context.  
    Public MethodOverloaded. Executes a VBScript statement in the current report context.  
    Public Method (Inherited from System.MarshalByRefObject)
    Public MethodGets 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 MethodGets 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 MethodEnumerates 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 MethodOverloaded. Gets a list of reports available in an XML report definition file.  
    Public Methodstatic (Shared in Visual Basic)Overloaded. Gets a list of reports available in an XML report definition file.  
    Public Method (Inherited from System.MarshalByRefObject)
    Public MethodOverloaded. Loads a report from an XML report definition in stream.  
    Public MethodParses a VBScript expression in the current report context.  
    Public MethodOverloaded. Parses a VBScript statement in the current report context.  
    Public MethodOverloaded. Prints the current report with default printer settings, not showing the print progress dialog.  
    Public MethodOverloaded. Shows the standard print dialog, allowing the user to print the current document.  
    Public MethodRenders the report into an internal collection of images.  
    Public MethodRenders the report into a file.  
    Public MethodRenders the report into an ExportFilter object.  
    Public MethodOverloaded. Renders the report into a System.IO.Stream object.  
    Public MethodOverloaded. Saves the current report definition to a file.  
    Public MethodAssigns specified values to the CreationDevice and CreationPrinterName properties. Using this method is more efficient than setting the two properties individually.  
    Public Method (Inherited from System.ComponentModel.Component)
    Top
    Protected Methods
     NameDescription
    Protected Method (Inherited from System.ComponentModel.Component)
    Protected Method (Inherited from System.ComponentModel.Component)
    Protected MethodOverloaded.  (Inherited from System.MarshalByRefObject)
    Protected MethodRaises the EndPage event.  
    Protected MethodRaises the EndReport event.  
    Protected MethodRaises the EndSection event.  
    Protected MethodRaises the NoData event.  
    Protected MethodRaises the PrintSection event.  
    Protected MethodRaises the ReportError event.  
    Protected MethodRaises the StartPage event.  
    Protected MethodRaises the StartReport event.  
    Protected MethodRaises the StartSection event.  
    Top
    Public Events
     NameDescription
    Public EventFired before the control adds an outline entry to the report.  
    Public Event (Inherited from System.ComponentModel.Component)
    Public EventFired when the control finishes rendering each page.  
    Public EventFired when the control finishes rendering the report.  
    Public EventFired when the control finishes rendering each Section.  
    Public EventFired before the control displays the Report Parameters dialog.  
    Public EventOccurs periodically during document generation. Allows to provide progress indication and the ability to cancel generation to the user.  
    Public EventFired when the control starts rendering a report and the data source is empty.  
    Public EventFired before each Section is printed (after it has been formatted.)  
    Public EventFired when an error occurs while rendering a report.  
    Public EventFired when the control starts rendering each page.  
    Public EventFired when the control starts rendering the report, before it opens the source recordset.  
    Public EventFired before each Section is formatted.  
    Top
    See Also