org.eclipse.birt.report.engine.api
Interface IRenderTask

All Superinterfaces:

IEngineTask

public interface IRenderTask

extends IEngineTask

An engine task that renders a Report Document to one of the output formats supported by the engine.

Field Summary

Fields inherited from interface org.eclipse.birt.report.engine.api.IEngineTask

STATUS_CANCELLED, STATUS_FAILED, STATUS_NOT_STARTED, STATUS_RUNNING, STATUS_SUCCEEDED

Method Summary

IRenderOption	getRenderOption()
void	render() render the whole report document or an output format
void	render(InstanceID iid) Deprecated. A page which contains the instance can be rendered like this: setInstanceID( instanceID ); render( );
void	render(long pageNumber) Deprecated. A page with speicfic page number can be rendered like this: setPageNumber( pageNumber ); render( );
void	render(java.lang.String pageRange) Deprecated. A range of pages can be rendered like this: setPageRange( pageRange ); render( );
void	setBookmark(java.lang.String bookmark) Sets bookmark.
void	setEmitterID(java.lang.String id) sets a specific emitter to use when generate output.
void	setInstanceID(InstanceID iid) Sets id of instance.
void	setInstanceID(java.lang.String iid) Sets id of instance which is a string type.
void	setPageNumber(long pageNumber) Sets number of the page to be rendered.
void	setPageRange(java.lang.String pageRange) Sets range of the pages to be rendered.
void	setRenderOption(IRenderOption options) set the rendering options
void	setReportlet(java.lang.String bookmark) Sets reportlet by bookmark.

Methods inherited from interface org.eclipse.birt.report.engine.api.IEngineTask

addScriptableJavaObject, cancel, cancel, close, getAppContext, getCancelFlag, getEngine, getErrors, getID, getLocale, getParameterDisplayText, getParameterValue, getParameterValues, getReportRunnable, getStatus, getULocale, setAppContext, setDataSource, setLocale, setLocale, setParameter, setParameterDisplayText, setParameterValue, setParameterValues, validateParameters

Method Detail

setRenderOption

public void setRenderOption(IRenderOption options)

set the rendering options

getRenderOption

public IRenderOption getRenderOption()

Returns:

the render option

setEmitterID

public void setEmitterID(java.lang.String id)

sets a specific emitter to use when generate output. Used when there are more than one emitters that support a single format. One example is the FO-based PDF emitter and the new PDF emitter added in BIRT2.0. If this function is not called when there are more than 1 emitters that support a format, engine may arbitrarily pick one.

Parameters:

id - the identifier for the emitter

setPageNumber

public void setPageNumber(long pageNumber)
                   throws EngineException

Sets number of the page to be rendered.

Parameters:

pageNumber - number of the page.

Throws:

EngineException - if pageNumber is invalid.

setInstanceID

public void setInstanceID(InstanceID iid)
                   throws EngineException

Sets id of instance. If instance id is set, render method will render the page which contains this instance.

Parameters:

iid - id of the instance.

Throws:

EngineException - if iid is invalid.

setInstanceID

public void setInstanceID(java.lang.String iid)
                   throws EngineException

Sets id of instance which is a string type. If instance id is set, render method will render the page which contains this instance.

Parameters:

iid - the string type instance id of the instance.

Throws:

EngineException - if iid is invalid.

setPageRange

public void setPageRange(java.lang.String pageRange)
                  throws EngineException

Sets range of the pages to be rendered.

Parameters:

pageRange - range of the pages.

Throws:

EngineException - if pageRange is invalid.

setBookmark

public void setBookmark(java.lang.String bookmark)
                 throws EngineException

Sets bookmark. If bookmark is set, render method will render the page which contains this bookmark.

Parameters:

bookmark - the bookmark.

Throws:

EngineException - if bookmark is invalid.

setReportlet

public void setReportlet(java.lang.String bookmark)
                  throws EngineException

Sets reportlet by bookmark. The reportlet represented by the bookmark will be render.

Parameters:

bookmark - the bookmark.

Throws:

EngineException - if bookmark is invalid.

render

public void render()
            throws EngineException

render the whole report document or an output format

Throws:

EngineException - if rendering fails

render

public void render(long pageNumber)
            throws EngineException

Deprecated. A page with speicfic page number can be rendered like this:
setPageNumber( pageNumber );
render( );

Parameters:

pageNumber -

Throws:

EngineException

render

public void render(java.lang.String pageRange)
            throws EngineException

Deprecated. A range of pages can be rendered like this:
setPageRange( pageRange );
render( );

Render the page from startPageNumber to endPageNumber in the Report Doucment to an output format.

Throws:

EngineException

render

public void render(InstanceID iid)
            throws EngineException

Deprecated. A page which contains the instance can be rendered like this:
setInstanceID( instanceID );
render( );

Render the Reportlet whose container is identified by iid. Useful for Reportlet support

Throws:

EngineException