![]() ![]() |
The TextData element displays a multi-line block of text that comes from the database, a file, or an expression. The text can be plain text or HTML. The format of the text can be fixed at design time or it can be dynamically selected at run time to match the format of the incoming text.
DesignElement->ReportElement->ReportItem
comments, customXml, dataSet, extends, height, name, paramBindings, style, userProperties
backgroundAttachment, backgroundColor, backgroundImage, borderBottomColor, borderBottomStyle, borderBottomWidth, borderLeftColor, borderLeftStyle, borderLeftWidth, borderRightColor, borderRightStyle, borderRightWidth, borderTopColor, borderTopStyle, borderTopWidth, canShrink, color, display, fontFamily, fontSize, fontStyle, fontVariant, fontWeight, letterSpacing, lineHeight, marginBottom, marginLeft, marginRight, marginTop, masterPage, paddingBottom, paddingLeft, paddingRight, paddingTop, pageBreakAfter, pageBreakBefore, showIfBlank, textAlign, textIndent, textLineThrough, textOverline, textTransform, textUnderline, verticalAlign, whiteSpace, wordSpacing
The following sections describe the properties of the TextData element.
Used to explicitly identify the format of the text. If this property's value is auto or it has no value, BIRT infers the format from the text.
BIRT determines the text format by examining the first few characters of the string. If the first characters are <HTML> or <html>, BIRT assumes HTML format. In every other case, BIRT assumes the text is plain text. Leading white space is ignored when determining the type of text.
An expression that returns a string. BIRT uses the string this expression returns to retrieve the text for the TextData report item. The expression can be a reference to a query column, a report parameter, a formula, a special value, a file, or another data item.
The following sections describe the methods of the TextData 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.
![]() ![]() |