# ExtendedItem

Represents an extended item, provide BIRT extenion capability.

### Description

Represents an extended item element. The extended report item allows third-party developers to create report items that work within BIRT virtually identically to BIRT-defined items.

Extended items can use the user-properties discussed above to define properties. Extended items are defined in a Java plug-in that contributes behavior to the Eclipse Report Developer, to the Factory and to the Presentation Engine.

The extended item can fully participate with the other BIRT extension facilities, meaning that report developers can add properties and scripts to an extended item, providing a very powerful way to create application-specific functionality. An extended item is defined by a plug-in. The plug-in is specific to BIRT, and is different from an Eclipse plug-in. Each item plug-in has four parts:

- Design: handles the model that describes the report item.
- User Interface: the UI displayed for the item. This is in the form of an Eclipse plug-in.
- Factory: how to gather the data for the extended item, and compute its default size in the Factory.
- Presentation: how to render the extended item when rendering the report to HTML, PDF or other formats.

### See Also

## onCreate

Script executed when the element is created in the Factory.

### Description

Executed when the element is created in the Factory. Called after the item is created, but before the item is saved to the report document file. See the scripting spec for additional information about this script. Applications should perform visual customization in the on-render script instead.

## onPrepare

It is for a script startup phase. No data binding yet. The design of an element can be changed here.

### Description

It is for a script startup phase. No data binding yet. The design of an element can be changed here.

## onRender

Script executed when the element is prepared for rendering in the Presentation engine.

### Description

Executed when the element is prepared for rendering in the Presentation engine. Changes made to the element are written to the target output format, but not saved to the report document file. This is the preferred place for visual customizations.

## extensionName

A unique extension name to identify the extension

### Description

Indicates which extension this extended item is extended from.

Using this name, BIRT can get the extension definition. The name is an internal name for an implementation of extension.

## filter

A list of filter conditions that can be applied to the extended item

### Description

A list of filter conditions that can be applied to the extended item