|
| IliHTMLReporter (IlvDisplay *display, const IlvPoint &at, IlUShort thickness=IlvDefaultGadgetThickness, IlvPalette *palette=0) |
| This constructor creates an HTML reporter with a classic table model type. More...
|
|
virtual IlvBitmap * | getBitmap () const |
| Returns the bitmap that is displayed during the design phase in Rogue Wave Views Data Access. More...
|
|
const char * | getColumnName (IlInt colno) const |
| Returns a column title. More...
|
|
const char * | getColumnValue (IlInt colno) const |
| Returns the column value of the current row. More...
|
|
const char * | getColumnValue (IliTableBuffer *buff, IlInt colno) const |
| Returns a column value of one buffer. More...
|
|
IliDataSource * | getDataSource () const |
| Returns the data source that will be used to create the document. More...
|
|
const char * | getDataSourceName () const |
| Return the data source name that will be used to create the document. More...
|
|
const char * | getDocumentBackground () const |
| Returns the document background color. More...
|
|
const char * | getDocumentCopyright () const |
| Returns the document copyright. More...
|
|
const char * | getDocumentTitle () const |
| Returns the document title. More...
|
|
const char * | getFilename () const |
| Returns the document file name. More...
|
|
const char * | getFirstPagePictureName () const |
| Returns the file name for the first page picture. More...
|
|
const char * | getFirstPageTitle () const |
| Returns the title for the first page. More...
|
|
const char * | getModelName () const |
| Returns the document model name. More...
|
|
IliHTMLModelName | getPredefinedModel () const |
| Returns the document model type. More...
|
|
IlInt | getRowCount () const |
| Returns the row count of the table. More...
|
|
const char * | getRowLocationName () const |
| Returns the row location name. More...
|
|
IlInt | getRowNumber () const |
| Returns the number of the current row. More...
|
|
std::ostream & | getStream () const |
| Returns the stream associated with the file. More...
|
|
const IliTable * | getTable () const |
| Returns the table used to create the document. More...
|
|
const IliTableBuffer * | getTableBuffer () const |
| Returns the data of the current row. More...
|
|
const char * | getTableOfContentsColumnName () const |
| Returns the column name of the data source. More...
|
|
const char * | getTableOfContentsEntry () const |
| Returns the text for an entry of the table of contents. More...
|
|
const char * | getTableOfContentsLocation () const |
| Returns the table of contents entry location. More...
|
|
const char * | getTableOfContentsTitle () const |
| Returns the table of contents title. More...
|
|
IlBoolean | hasTableOfContents () const |
| Returns IlTrue if a table of contents will be created. More...
|
|
IlBoolean | isColumnVisible (IlInt colno) const |
| Returns IlTrue if a column is visible. More...
|
|
IlBoolean | isTableOfContentsAtBeginning () const |
| Returns IlTrue if the table of contents begins just after the first page. More...
|
|
void | report () |
| Creates the document.
|
|
virtual void | reportBeginDocument () |
| Called at the beginning of the document.
|
|
virtual void | reportBeginRows () |
| Called just before the first row is created if the model is a table style. Otherwise, it is called just after each row is created.
|
|
virtual void | reportEndDocument () |
| Called at the end of the document.
|
|
virtual void | reportEndRows () |
| Called just after the last row is created if the model is a table style. Otherwise, it is called just after each row is created.
|
|
virtual void | reportFirstPageContents () |
| Called to create the first page contents.
|
|
virtual void | reportFirstPageFooting () |
| Called to create the first page footing.
|
|
virtual void | reportFirstPageHeading () |
| Called to create the first page heading.
|
|
virtual void | reportFooting () |
| Called to create the page footing.
|
|
virtual void | reportHeading () |
| Called to create the page heading.
|
|
virtual void | reportLastPageContents () |
| Called to create the contents of the last page.
|
|
virtual void | reportLastPageFooting () |
| Called to create the last page footing.
|
|
virtual void | reportLastPageHeading () |
| Called to create the last page heading.
|
|
virtual void | reportRowContent () |
| Called to create the row contents.
|
|
virtual void | reportTableBeginEntries () |
| Called just before the first entry is created.
|
|
virtual void | reportTableEndEntries () |
| Called just after the last entry is created.
|
|
virtual void | reportTableEntry () |
| Called to create an entry of the table of contents.
|
|
virtual void | reportTableFooting () |
| Called to create the table of contents footing.
|
|
virtual void | reportTableHeading () |
| Called to create the table of contents heading.
|
|
virtual void | reportTableTitle () |
| Called to create the table of contents title.
|
|
void | setDataSource (IliDataSource *ds) |
| Sets the data source that will be used to create the document. More...
|
|
void | setDataSourceName (const char *name) |
| Sets the data source name that will be used to create the document. More...
|
|
void | setDocumentBackground (const char *color) |
| Sets the document background color. More...
|
|
void | setDocumentCopyright (const char *cop) |
| Sets the document copyright. More...
|
|
void | setDocumentTitle (const char *title) |
| Sets the document title. More...
|
|
void | setFilename (const char *name) |
| Sets the document file name. More...
|
|
void | setFirstPagePictureName (const char *name) |
| Sets the file name for the first page picture. More...
|
|
void | setFirstPageTitle (const char *title) |
| Sets the title for the first page. More...
|
|
void | setModelName (const char *mod) |
| Sets the document model name. More...
|
|
void | setPredefinedModel (IliHTMLModelName mod) |
| Sets the document model type. More...
|
|
void | setTableOfContents (IlBoolean has) |
| Indicates if the table of contents must be created. More...
|
|
void | setTableOfContentsAtBeginning (IlBoolean beginning) |
| Specifies the location of the table of contents. More...
|
|
void | setTableOfContentsColumnName (const char *name) |
| Sets the column name of the data source. More...
|
|
void | setTableOfContentsTitle (const char *title) |
| Sets the table of contents title. More...
|
|
void | tagBar (IlInt size=2) |
| Writes the HTML tag horizontal bar. More...
|
|
void | tagBeginBody (const char *color=0, const char *opt=0) |
| Writes the HTML tag to define the beginning of the visible document. More...
|
|
void | tagBeginBold () |
| Writes the HTML tag for begin bold. More...
|
|
void | tagBeginCenter () |
| Writes the HTML tag for begin center. More...
|
|
void | tagBeginCodeListing () |
| Writes the HTML tag for begin code listing. More...
|
|
void | tagBeginFont (const char *opt=0) |
| Writes the HTML tag for begin font. More...
|
|
void | tagBeginForm (const char *opt=0) |
| Writes the HTML tag for begin form. More...
|
|
void | tagBeginHead () |
| Writes the HTML tag for begin head. More...
|
|
void | tagBeginHeader (IlInt size=2, IlvAlignment align=IlvLeft) |
| Writes the HTML tag to begin the headers. More...
|
|
void | tagBeginHtml () |
| Writes the HTML tag for begin HTML document. More...
|
|
void | tagBeginItalic () |
| Writes the HTML tag for begin italic. More...
|
|
void | tagBeginList () |
| Writes the HTML tag for begin list. More...
|
|
void | tagBeginListItem () |
| Writes the HTML tag for begin list item. More...
|
|
void | tagBeginListOrdered () |
| Writes the HTML tag for begin ordered list. More...
|
|
void | tagBeginScript (const char *opt=0) |
| Writes the HTML tag for begin script. More...
|
|
void | tagBeginStrong () |
| Writes the HTML tag for begin strong. More...
|
|
void | tagBeginTable (const char *opt=0) |
| Writes the HTML tag for begin table. More...
|
|
void | tagBeginTableColumn (const char *opt=0) |
| Writes the HTML tag for begin table column. More...
|
|
void | tagBeginTableHeader (const char *opt=0) |
| Writes the HTML tag for begin table header. More...
|
|
void | tagBeginTableRow (const char *opt=0) |
| Writes the HTML tag for begin table row. More...
|
|
void | tagBeginUnderline () |
| Writes the HTML tag for begin underline. More...
|
|
void | tagDefineLocation (const char *loc, const char *text) |
| Writes the HTML tag to define a location. More...
|
|
void | tagEndBody () |
| Writes the HTML tag for end body. More...
|
|
void | tagEndBold () |
| Writes the HTML tag for end bold. More...
|
|
void | tagEndCenter () |
| Writes the HTML tag for end center. More...
|
|
void | tagEndCodeListing () |
| Writes the HTML tag for end code listing. More...
|
|
void | tagEndFont () |
| Writes the HTML tag for end font. More...
|
|
void | tagEndHead () |
| Writes the HTML tag for end head. More...
|
|
void | tagEndHeader (IlInt size=2) |
| Writes the HTML tag to end headers. More...
|
|
void | tagEndHtml () |
| Writes the HTML tag for end HTML document. More...
|
|
void | tagEndItalic () |
| Writes the HTML tag for end italic. More...
|
|
void | tagEndList () |
| Writes the HTML tag for end list. More...
|
|
void | tagEndListItem () |
| Writes the HTML tag for end list item. More...
|
|
void | tagEndListOrdered () |
| Writes the HTML tag for end ordered list. More...
|
|
void | tagEndStrong () |
| Writes the HTML tag for end strong. More...
|
|
void | tagEndTable () |
| Writes the HTML tag for end table. More...
|
|
void | tagEndTableColumn () |
| Writes the HTML tag for end table column. More...
|
|
void | tagEndTableHeader () |
| Writes the HTML tag for end table header. More...
|
|
void | tagEndTableRow () |
| Writes the HTML tag for end table row. More...
|
|
void | tagEndUnderline () |
| Writes the HTML tag for end underline. More...
|
|
void | tagHeadTitle (const char *title) |
| Writes the HTML tag to define the document title. More...
|
|
void | tagLinkToFile (const char *file, const char *text) |
| Writes the HTML tag to define a link to a file. More...
|
|
void | tagLinkToFileLocation (const char *file, const char *loc, const char *txt) |
| Writes the HTML tag to define a link to a location in a file. More...
|
|
void | tagLinkToLocation (const char *link, const char *text) |
| Writes the HTML tag to define a link to a location. More...
|
|
void | tagNewLine (IlInt count=1) |
| Writes several times the HTML tag new line. More...
|
|
void | tagParagraph () |
| Writes the HTML tag new paragraph. More...
|
|
void | tagPicture (const char *filename, const char *opt=0) |
| Writes the HTML tag to insert a picture. More...
|
|
void | tagSpace () |
| Writes the HTML tag for a space. More...
|
|
void | tagText (const char *text) |
| Writes text or HTML tags or both. More...
|
|
void | tagTradeMark () |
| Writes the HTML tag for Trade Mark. More...
|
|
IlBoolean | hasGlobalScope () const |
| Indicates the data source scope. More...
|
|
IlBoolean | isSystemUsage () const |
| Indicates the system usage flag. More...
|
|
virtual void | setGlobalScope (IlBoolean global) |
| Specifies whether the scope of the name of the data gem is local to the container in which it is located or globally visible. More...
|
|
virtual void | usedBySystem (IlBoolean usage) |
| Specifies if the object is a system object. More...
|
|
Gadget class.
Library: dbgadget
The IliHTMLReporter
class defines a gadget that can be used to generate an HTML document containing the data of a data source. You can specify if you want a table of contents and if the table of contents is positioned after the first page of the document or before the last page of the document. There are four models of document:
-
Classic Table-The data are written into a table. The background is gray and the foreground is black.
-
Table-The data are written into a table. The background is white and the foreground is blue.
-
Classic Form-Each row of the data source is written into a form. The background is gray and the foreground is black.
-
Form-Each row of the data source is written into a form. The background is white and the foreground is blue.
-
Dynamic form-A form displays the current row of the data source of the HTML Document. There is a navigator to change the current row.
Each part of the document is associated with a virtual function and a callback. The calling order depends on the type of document model:
-
If the model type is a classic table or a table, the calling order is the following:
reportBeginDocument
reportFirstPageHeading
reportFirstPageContents
reportFirstPageFooting
- For documents with the table of contents at the beginning of the document, the following are then called:
reportTableHeading
reportTableTitle
reportTableBeginEntries
reportTableEntry
is called for each entry of the table of contents
reportTableEndEntries
reportTableFooting
reportHeading
reportBeginRows
reportRowContent
is called for each row of the data source
reportEndRows
reportFooting
- For documents with the table of contents at the end of the document, the following are then called:
reportTableHeading
reportTableTitle
reportTableBeginEntries
reportTableEntry
is called for each entry of the table of contents
reportTableEndEntries
reportTableFooting
reportLastPageHeading
reportLastPageContents
reportLastPageFooting
reportEndDocument
-
If the model type is a classic form or a form, the calling order is the following:
reportBeginDocument
reportFirstPageHeading
reportFirstPageContents
reportFirstPageFooting
- For documents with the table of contents at the beginning of the document, the following are then called:
reportTableHeading
reportTableTitle
reportTableBeginEntries
reportTableEntry
is called for each entry of the table of contents
reportTableEndEntries
reportTableFooting
- For each row of the data source, the following functions are called:
reportHeading
reportBeginRows
reportRowContent
reportEndRows
reportFooting
- For documents with the table of contents at the end of the document, the following are then called:
reportTableHeading
reportTableTitle
reportTableBeginEntries
reportTableEntry
is called for each entry of the table of contents
reportTableEndEntries
reportTableFooting
reportLastPageHeading
reportLastPageContents
reportLastPageFooting
reportEndDocument
- Note
- A column is not written if it is not visible.
-
If you define the callback rowContent, you must call
tagDefineLocation
function within your row description to insert the row location (used by table of contents). The row location is provided by the rowLocationName
property.
About table of contents To create the table of contents, the HTML reporter uses the data of a data source column. For each row, there is a table of contents entry. The entry text is the content of the column for the row.
- See also
IliDataGem
, IliXML
.
Accessors
Accessors provide a scriptable and uniform way to inspect and modify an object by using its base class methods IlvValueInterface::queryValue()
, IlvValueInterface::queryValues()
, IlvValueInterface::changeValue()
, IlvValueInterface::changeValues()
. This class defines the following accessors:
Data accessors
Name | Type | Equivalent methods |
dataSourceName | String | getDataSourceName() , setDataSourceName() |
documentBackground | String | getDocumentBackground() , setDocumentBackground() |
documentCopyright | String | getDocumentCopyright() , setDocumentCopyright() |
documentTitle | String | getDocumentTitle() , setDocumentTitle() |
filename | String | getFilename() , setFilename() |
firstPagePictureName | String | getFirstPagePictureName() , setFirstPagePictureName() |
firstPageTitle | String | getFirstPageTitle() , setFirstPageTitle() |
model | IliValueModelName | getPredefinedModel() , setPredefinedModel() |
rowCount | Int | getRowCount() |
rowLocationName | String | getRowLocationName() |
rowNumber | Int | getRowNumber() |
tableOfContents | Boolean | hasTableOfContents() , setTableOfContents() |
tableOfContentsAtBeginning | Boolean | isTableOfContentsAtBeginning() , setTableOfContentsAtBeginning() |
tableOfContentsColumnName | String | getTableOfContentsColumnName() , setTableOfContentsColumnName() |
tableOfContentsEntry | String | getTableOfContentsEntry() |
tableOfContentsLocation | String | getTableOfContentsLocation() |
tableOfContentsTitle | String | getTableOfContentsTitle() , setTableOfContentsTitle() |
Method accessors
Name | Return type | Equivalent methods |
getColumnName(Int col) | String | getColumnName(col) |
getColumnValue(Int col) | String | getColumnValue(col) const |
isColumnVisible(Int col) | Boolean | isColumnVisible(col) const |
report() | Void | report() |
tagBar(Int size) | Void | tagBar(size) |
tagBeginBody(String color, String opt) | Void | tagBeginBody(color, opt) |
tagBeginBold() | Void | tagBeginBold() |
tagBeginCenter() | Void | tagBeginCenter() |
tagBeginCodeListing() | Void | tagBeginCodeListing() |
tagBeginFont(String opt) | Void | tagBeginFont(opt) |
tagBeginHead() | Void | tagBeginHead() |
tagBeginHeader(Int size, IlvAlignment align) | Void | tagBeginHeader(size, align) |
tagBeginHtml() | Void | tagBeginHtml() |
tagBeginItalic() | Void | tagBeginItalic() |
tagBeginList() | Void | tagBeginList() |
tagBeginListItem() | Void | tagBeginListItem() |
tagBeginListOrdered() | Void | tagBeginListOrdered() |
tagBeginStrong() | Void | tagBeginStrong() |
tagBeginTable(String opt) | Void | tagBeginTable(opt) |
tagBeginTableColumn(String opt) | Void | tagBeginTableColumn(opt) |
tagBeginTableHeader(String opt) | Void | tagBeginTableHeader(opt) |
tagBeginTableRow(String opt) | Void | tagBeginTableRow(opt) |
tagBeginUnderline() | Void | tagBeginUnderline() |
tagDefineLocation(String location, String text) | Void | tagDefineLocation(location, text) |
tagEndBody() | Void | tagEndBody() |
tagEndBold() | Void | tagEndBold() |
tagEndCenter() | Void | tagEndCenter() |
tagEndCodeListing() | Void | tagEndCodeListing() |
tagEndFont() | Void | tagEndFont() |
tagEndHead() | Void | tagEndHead() |
tagEndHeader(Int size) | Void | tagEndHeader(size) |
tagEndHtml() | Void | tagEndHtml() |
tagEndItalic() | Void | tagEndItalic() |
tagEndList() | Void | tagEndList() |
tagEndListItem() | Void | tagEndListItem() |
tagEndListOrdered() | Void | tagEndListOrdered() |
tagEndStrong() | Void | tagEndStrong() |
tagEndTable() | Void | tagEndTable() |
tagEndTableColumn() | Void | tagEndTableColumn() |
tagEndTableHeader() | Void | tagEndTableHeader() |
tagEndTableRow() | Void | tagEndTableRow() |
tagEndUnderline() | Void | tagEndUnderline() |
tagHeadTitle(String title) | Void | tagHeadTitle(title) |
tagLinkToFile(String file, String text) | Void | tagLinkToFile(file, text) |
tagLinkToFileLocation(String file, String location, String text) | Void | tagLinkToFileLocation(file, location, text) |
tagLinkToLocation(String location, String text) | Void | tagLinkToLocation(location, text) |
tagNewLine(Int count) | Void | tagNewLine(count) |
tagParagraph() | Void | tagParagraph() |
tagPicture(String filename, String opt) | Void | tagPicture(filename, opt) |
tagSpace() | Void | tagSpace() |
tagText(String text) | Void | tagText(text) |
tagTradeMark() | Void | tagTradeMark() |