:: com :: sun :: star :: report ::

interface XReportEngine
Base Interfaces
XReportEngine
┣ ::com::sun::star::lang::XComponent
┗ ::com::sun::star::beans::XPropertySet

::com::sun::star::lang::XComponent
Description
allows life-time control of report engine.
::com::sun::star::beans::XPropertySet
Description
gives access to the properties.

Methods' Summary
createDocumentModel creates a report document.  
createDocumentAlive creates a report document.  
createDocument creates a report document.  
interrupt allows to interrupt the creation process of the report document.  
Attributes' Summary
ReportDefinition specifies the report definition object which is used to create the resulting report.  
ActiveConnection specifies the active connection which is used to create the resulting report.  
StatusIndicator specifies the status indicator which shows the progress of the report generation process.  
MaxRows defines the maximum number of rows which should be fetched for the report. If the limit is exceeded, the excess rows are silently dropped.
There is no limitation, if set to zero.  
Methods' Details
createDocumentModel
::com::sun::star::frame::XModel
createDocumentModel()
raises( ::com::sun::star::lang::DisposedException,
::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::uno::Exception );

Description
creates a report document.
Throws
::com::sun::star::lang::DisposedException If the report engine is already disposed.
Throws
::com::sun::star::lang::IllegalArgumentException If the report definition was not set or is NULL.
createDocumentAlive
::com::sun::star::frame::XModel
createDocumentAlive( [in] ::com::sun::star::frame::XFrame  frame )
raises( ::com::sun::star::lang::DisposedException,
::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::uno::Exception );

Description
creates a report document.
Parameter _frame
The frame must have a controller set. This controller will be set at the model.
Throws
::com::sun::star::lang::DisposedException If the report engine is already disposed.
Throws
::com::sun::star::lang::IllegalArgumentException If the report definition was not set or is NULL. OJ: Has to be discussed if this method is useful.
createDocument
::com::sun::star::util::URL
createDocument()
raises( ::com::sun::star::lang::DisposedException,
::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::uno::Exception );

Description
creates a report document.
Returns
The URL where the new document is located.
Throws
::com::sun::star::lang::DisposedException If the report engine is already disposed.
Throws
::com::sun::star::lang::IllegalArgumentException If the report definition was not set or is NULL.
interrupt
void
interrupt()
raises( ::com::sun::star::lang::DisposedException,
::com::sun::star::uno::Exception );

Description
allows to interrupt the creation process of the report document.
Throws
::com::sun::star::lang::DisposedException If the report engine is already disposed.
Attributes' Details
ReportDefinition
[ bound ] XReportDefinition ReportDefinition
set raises (::com::sun::star::lang::IllegalArgumentException);

Description
specifies the report definition object which is used to create the resulting report.
ActiveConnection
[ bound ] ::com::sun::star::sdbc::XConnection ActiveConnection
set raises (::com::sun::star::lang::IllegalArgumentException);

Description
specifies the active connection which is used to create the resulting report.
StatusIndicator
::com::sun::star::task::XStatusIndicator StatusIndicator;
Description
specifies the status indicator which shows the progress of the report generation process.
MaxRows
[ bound ] long MaxRows;
Description
defines the maximum number of rows which should be fetched for the report. If the limit is exceeded, the excess rows are silently dropped.
There is no limitation, if set to zero.
Top of Page