![]() ![]() |
The Grid element contains a set of report items that are arranged into a grid. Each cell in the grid can contain a single item. A grid is in row-major format. In other words, a grid is a list of rows that contain cells.
Grid data is divided into rows and columns. You can apply a grid layout to a list to align column headings with detail rows. You can also apply a grid to a dashboard to create a clean, organized layout. You can also apply a grid to the entire report to align data in a group of dashboards and lists.
Grid rows grow or shrink depending on content. Grid columns ensure that items line up vertically. Columns also grow or shrink depending on their contents.
Some of the benefits of using a grid versus free-form layout include:
DesignElement->ReportElement->ReportItem
None
comments, customXml, dataSet, extends, height, name, paramBindings, style, userProperties
backgroundColor, backgroundImage, borderBottomColor, borderBottomStyle, borderBottomWidth, borderLeftColor, borderLeftStyle, borderLeftWidth, borderRightColor, borderRightStyle, borderRightWidth, borderTopColor, borderTopStyle, borderTopWidth, canShrink, color, dateTimeFormat, display, fontFamily, fontSize, fontStyle, fontVariant, fontWeight, highlightRules, highlightTestExpr, letterSpacing, lineHeight, mapRules, mapTestExpr, marginBottom, marginLeft, marginRight, marginTop, masterPage, numberAlign, numberFormat, orphans, paddingBottom, paddingLeft, paddingRight, paddingTop, pageBreakAfter, pageBreakBefore, pageBreakInside, showIfBlank, stringFormat, textAlign, textIndent, textLineThrough, textOverline, textTransform, textUnderline, verticalAlign, whiteSpace, widows, wordSpacing
The following sections describe the slots of the Grid element.
The columns that make up the grid. The columns property describes the columns within the table. This property is optional. If omitted, BIRT infers the columns from the table structure and sizes the columns based on their contents. If this property contains data, the grid must contain no more columns than defined in the grid. Use this property when you want to control the size, color, border, or other properties of each column.
Any number of row entries. Contains a list of the rows that make up the grid.
The following sections describe the methods of the Grid element.
The method that BIRT executes to handle the onCreate event for this element. The onCreate method executes every time the element is generated. Use the onCreate method to perform tasks that are data dependent.
The method that BIRT executes to handle the onPrepare event for this element. the onPrepare method executes once prior to the generation of the report. Use onPrepare method to perform tasks that affect the appearance of the element for every occurrence in the report.
The method that BIRT executes to handle the onRender event for this element. The onRender method executes at run time and not at generation time. Use the onRender method to perform tasks that are dependent on the run time details. Examples of run time factors that might require special handling include the run time environment, the user requesting the report, the parameter values in effect when the report is run, and whether the report is produced in HTML or PDF format.
![]() ![]() |