|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.eclipse.birt.report.model.api.DesignElementHandle
org.eclipse.birt.report.model.api.ModuleHandle
org.eclipse.birt.report.model.api.ReportDesignHandle
Represents the overall report design. The report design defines a set of properties that describe the design as a whole like author, base and comments etc.
Besides properties, it also contains a variety of elements that make up the report. These include:
Content Item | Description |
---|---|
Code Modules | Global scripts that apply to the report as a whole. |
Parameters | A list of Parameter elements that describe the data that the user can enter when running the report. |
Data Sources | The connections used by the report. |
Data Sets | Data sets defined in the design. |
Color Palette | A set of custom color names as part of the design. |
Styles | User-defined styles used to format elements in the report. Each style must have a unique name within the set of styles for this report. |
Page Setup | The layout of the master pages within the report. |
Components | Reusable report items defined in this design. Report items can extend these items. Defines a "private library" for this design. |
Body | A list of the visual report content. Content is made up of one or more sections. A section is a report item that fills the width of the page. It can contain Text, Grid, List, Table, etc. elements |
Scratch Pad | Temporary place to move report items while restructuring a report. |
Translations | The list of externalized messages specifically for this report. |
Images | A list of images embedded in this report. |
Module allow to use the components defined in Library
.
ModuleHandle.includeLibrary(String, String)
to include one
library.
// Include one library ReportDesignHandle designHandle = ...; designHandle.includeLibrary( "libA.rptlibrary", "LibA" ); LibraryHandle libraryHandle = designHandle.getLibrary("LibA"); // Create one label based on the one in library LabelHandle labelHandle = (LabelHandle) libraryHandle.findElement("companyNameLabel"); LabelHandle myLabelHandle = (LabelHandle) designHandle.getElementFactory().newElementFrom( labelHandle, "myLabel" ); // Add the new label into design file designHandle.getBody().add(myLabelHandle);
ReportDesign
Field Summary |
Fields inherited from class org.eclipse.birt.report.model.api.ModuleHandle |
isInitialized |
Fields inherited from class org.eclipse.birt.report.model.api.DesignElementHandle |
module |
Fields inherited from interface org.eclipse.birt.report.model.elements.interfaces.IReportDesignModel |
AFTER_FACTORY_METHOD, AFTER_RENDER_METHOD, BEFORE_FACTORY_METHOD, BEFORE_RENDER_METHOD, BODY_SLOT, CHARSET, CHEAT_SHEET_PROP, ICON_FILE_PROP, REFRESH_RATE_PROP, SCRATCH_PAD_SLOT, SLOT_COUNT, STYLE_SLOT, TEMPLATE_PARAMETER_DEFINITION_SLOT, THUMBNAIL_PROP |
Fields inherited from interface org.eclipse.birt.report.model.api.core.IModuleModel |
AUTHOR_PROP, BASE_PROP, COLOR_PALETTE_PROP, COMPONENT_SLOT, CONFIG_VARS_PROP, CREATED_BY_PROP, DATA_SET_SLOT, DATA_SOURCE_SLOT, DESCRIPTION_ID_PROP, DESCRIPTION_PROP, HELP_GUIDE_PROP, IMAGES_PROP, INCLUDE_RESOURCE_PROP, INCLUDE_SCRIPTS_PROP, INITIALIZE_METHOD, LIBRARIES_PROP, PAGE_SLOT, PARAMETER_SLOT, PROPERTY_BINDINGS_PROP, SCRIPTLIBS_PROP, THEME_PROP, TITLE_ID_PROP, TITLE_PROP, UNITS_PROP |
Fields inherited from interface org.eclipse.birt.report.model.elements.interfaces.IDesignElementModel |
COMMENTS_PROP, CUSTOM_XML_PROP, DISPLAY_NAME_ID_PROP, DISPLAY_NAME_PROP, EVENT_HANDLER_CLASS_PROP, EXTENDS_PROP, FULL_LABEL, ID_SUFFIX, NAME_PROP, NO_SLOT, PROPERTY_MASKS_PROP, REF_TEMPLATE_PARAMETER_PROP, SHORT_LABEL, USER_LABEL, USER_PROPERTIES_PROP, VIEW_ACTION_PROP |
Constructor Summary | |
ReportDesignHandle(org.eclipse.birt.report.model.elements.ReportDesign design)
Constructs a handle with the given design. |
Method Summary | |
void |
deleteThumbnail()
Deletes the thumbnail image in the design. |
java.lang.String |
getAfterFactory()
Returns the script called at the end of the Factory after closing the report document (if any). |
java.lang.String |
getAfterRender()
Returns the script called after starting a presentation time action. |
java.util.List |
getAllBookmarks()
Gets all bookmarks defined in this module. |
java.util.List |
getAllTocs()
Gets all TOCs defined in this module. |
java.lang.String |
getBase()
Returns the base directory to use when computing relative links from this report. |
java.lang.String |
getBeforeFactory()
Returns the script called at the start of the Factory after the initialize( ) method and before opening the report document (if any). |
java.lang.String |
getBeforeRender()
Returns the script called before starting a presentation time action. |
SlotHandle |
getBody()
Returns a slot handle to work with the sections in the report's Body slot. |
java.lang.String |
getCheatSheet()
Gets the design cheat sheet file path. |
java.lang.String |
getDisplayName()
Gets the display name. |
java.lang.String |
getDisplayNameKey()
Gets the resource key of the display name. |
java.lang.String |
getIconFile()
Gets the design icon/thumbnail file path. |
int |
getRefreshRate()
Returns the refresh rate when viewing the report. |
java.util.List |
getReportItemsBasedonTempalates()
Gets report items which holds a template definition, that is, report item in body slot and page slot. |
SlotHandle |
getScratchPad()
Returns a slot handle to work with the scratched elements within the report, which are no longer needed or are in the process of rearranged. |
SlotHandle |
getStyles()
Returns a slot handle to work with the styles within the report. |
byte[] |
getThumbnail()
Gets the thumbnail image encoded in ISO-8859-1. |
void |
importCssStyles(CssStyleSheetHandle stylesheet,
java.util.List selectedStyles)
Imports the selected styles in a CssStyleSheetHandle to
the module. |
java.util.Iterator |
includeScriptsIterator()
Returns the iterator over all included scripts. |
void |
setAfterFactory(java.lang.String value)
Sets the script called at the end of the Factory after closing the report document (if any). |
void |
setAfterRender(java.lang.String value)
Sets the script called after starting a presentation time action. |
void |
setBase(java.lang.String base)
Sets the base directory to use when computing relative links from this report. |
void |
setBeforeFactory(java.lang.String value)
Sets the script called at the start of the Factory after the initialize( ) method and before opening the report document (if any). |
void |
setBeforeRender(java.lang.String value)
Sets the script called before starting a presentation time action. |
void |
setCheatSheet(java.lang.String cheatSheet)
Sets the design cheat sheet file path. |
void |
setDisplayName(java.lang.String displayName)
Sets the display name. |
void |
setDisplayNameKey(java.lang.String displayNameKey)
Sets the resource key of the display name. |
void |
setIconFile(java.lang.String iconFile)
Sets the design icon/thumbnail file path. |
void |
setRefreshRate(int rate)
Sets the refresh rate when viewing the report. |
void |
setThumbnail(byte[] data)
Sets the thumbnail image encoded in ISO-8859-1. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public ReportDesignHandle(org.eclipse.birt.report.model.elements.ReportDesign design)
design
- the report designMethod Detail |
public java.lang.String getAfterFactory()
public java.lang.String getAfterRender()
public java.lang.String getBase()
public java.lang.String getBeforeFactory()
public java.lang.String getBeforeRender()
public SlotHandle getBody()
public int getRefreshRate()
public SlotHandle getScratchPad()
public java.util.Iterator includeScriptsIterator()
IncludeScriptHandle
IncludeScriptHandle
public void setAfterFactory(java.lang.String value)
value
- the script to set.public void setAfterRender(java.lang.String value)
value
- the script to set.public void setBase(java.lang.String base)
base
- the base directory to setpublic void setBeforeFactory(java.lang.String value)
value
- the script to set.public void setBeforeRender(java.lang.String value)
value
- the script to set.public void setRefreshRate(int rate)
rate
- the refresh ratepublic SlotHandle getStyles()
getStyles
in class ModuleHandle
public void importCssStyles(CssStyleSheetHandle stylesheet, java.util.List selectedStyles)
ModuleHandle
CssStyleSheetHandle
to
the module. Each in the list is instance of
SharedStyleHandle
.If any style selected has a duplicate
name with that of one style already existing in the report design, this
method will rename it and then add it to the design.
importCssStyles
in class ModuleHandle
stylesheet
- the style sheet handle that contains all the selected stylesselectedStyles
- the selected style listpublic void setDisplayNameKey(java.lang.String displayNameKey) throws SemanticException
displayNameKey
- the resource key of the display name
SemanticException
- if the display name resource-key property is locked or not
defined on this design.public java.lang.String getDisplayNameKey()
public void setDisplayName(java.lang.String displayName) throws SemanticException
displayName
- the display name
SemanticException
- if the display name property is locked or not defined on this
design.public java.lang.String getDisplayName()
public void setIconFile(java.lang.String iconFile) throws SemanticException
iconFile
- the design icon/thumbnail file path to set
SemanticException
- if the property is locked or not defined on this design.public java.lang.String getIconFile()
public void setCheatSheet(java.lang.String cheatSheet) throws SemanticException
cheatSheet
- the design cheat sheet file path to set
SemanticException
- if the property is locked or not defined on this design.public java.lang.String getCheatSheet()
public void setThumbnail(byte[] data) throws SemanticException
data
- the thumbnail image to set
SemanticException
- if the property is locked or not defined on this design.public byte[] getThumbnail()
public void deleteThumbnail() throws SemanticException
SemanticException
- if the property is locked or not defined on this design.public java.util.List getAllBookmarks()
public java.util.List getAllTocs()
public java.util.List getReportItemsBasedonTempalates()
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |