Report Item UI Extension Point

org.eclipse.birt.report.designer.ui.reportitemUI

1.0

This extension point is used in conjunction with the Report Item extension point defined in the model. It is used to register the GUI to be used for the Extended report item.

<!ELEMENT extension ((reportItemFigureUI | reportItemLabelUI | reportItemImageUI) , model , builder? , propertyPage? , palette? , editor? , outline? , description?)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT model EMPTY>

<!ATTLIST model

extensionName CDATA #REQUIRED>


<!ELEMENT reportItemFigureUI EMPTY>

<!ATTLIST reportItemFigureUI

class CDATA #REQUIRED>


<!ELEMENT reportItemLabelUI EMPTY>

<!ATTLIST reportItemLabelUI

class CDATA #REQUIRED>


<!ELEMENT reportItemImageUI EMPTY>

<!ATTLIST reportItemImageUI

class CDATA #REQUIRED>


<!ELEMENT builder EMPTY>

<!ATTLIST builder

class CDATA #IMPLIED>

Optional Builder for the element inside the Editor. Instantiated when a new item is dragged from the palette inside the editor.



<!ELEMENT propertyPage EMPTY>

<!ATTLIST propertyPage

class CDATA #IMPLIED>

Optional Property Edit Page for the item to be used in the Property Edit View



<!ELEMENT palette EMPTY>

<!ATTLIST palette

icon                CDATA #IMPLIED

category            CDATA #IMPLIED

categoryDisplayName CDATA #IMPLIED>


<!ELEMENT editor EMPTY>

<!ATTLIST editor

showInMasterPage (true | false) "true"

showInDesigner   (true | false) "true"

canResize        (true | false) "true">


<!ELEMENT outline EMPTY>

<!ATTLIST outline

icon CDATA #IMPLIED>


<!ELEMENT description (#PCDATA)>

an optional subelement whose body contains a short text describing what the UI extension will do



The following is an example of the extented element UI extension point:


<extension point=

"org.eclipse.birt.report.designer.reportitemUI"

>

<model extensionName=

"chart"

/>

<reportItemFigureUI class==

"org.eclipse.birt.chart.ChartAdapterUI"

/>

<palette icon=

"/icons/paletteimage.gif"

category=

"main"

/>

<editor showInMasterPage=

"false"

/>

<outline icon=

"/icons/outlineimage.gif"

/>

</extension>

The report item UI extension may implement the interfaces defined in the org.eclipse.birt.report.designer.ui.extensions package. See the package's JavaDoc documentation and API interfaces for more information.

The plugin org.eclipse.birt.chart.reportitem, supplied with the BIRT installation, provides a good example for implementing a report item UI extension.