TablePrint (Function) In french: TableImprime Prints the content of the specified Table control without having to create a report based on the Table control. An AAF (Automatic Application Feature) allows the user to directly print the content of the Table control (see Automatic menu of Table controls). TablePrint is used to configure the print: - Ability to specify the additional elements to print (date, number of pages, ...).
- It is possible to use iDestination to configure the print destination.
// Specify the print parameters
// Print in a PDF called table.pdf, in portrait mode
// Change the destination and the orientation.
iDestination(iGenericPDF, "./table.pdf")
iParameter(iOrientation, iOrientation_Portrait)
// Print the table (without option, everything is displayed)
TablePrint(TABLE_MyTable)
// Specify the print parameters
// Print in a PDF called table.pdf, in portrait mode
// Forces the Table control print AAF to use
// the parameters of the Table control (cell color, etc.)
ConfigureAAF(aafPrintReportOnTable, 1)
// Change the destination and the orientation.
iDestination(iGenericPDF, "./table.pdf")
iParameter(iOrientation, iOrientation_Portrait)
// Print the Table control (without option, everything is displayed)
TablePrint(TABLE_MyTable)
// Specify the print parameters
// Print in a PDF called table.pdf, in portrait mode
// Forces the Table control print AAF to use
// the parameters of the Table control (cell color, etc.)
AAFConfigure(aafPrintReportOnTable, 1)
// Change the destination and the orientation.
iDestination(iGenericPDF, "./table.pdf")
iParameter(iOrientation, iOrientation_Portrait)
// Print the Table control (without option, everything is displayed)
TablePrint(TABLE_MyTable)
Syntax
<Result> = TablePrint(<Table control> [, <Options>])
<Result>: Boolean - True if the print was performed,
- False if an error occurred.
<Table control>: Control name Name of Table control to use. <Options>: Optional Integer constant (or combination of constants) Configure the print for the content of the Table control: | | | WithMultipageColumns | If the Table control exceeds the page size, the columns found in the Table control are printed over several pages. | | WithDate | Prints the date at the top of the page. | | WithNbRecords | Prints the number of records at the end of the document. The caption used corresponds to the caption defined for the counter (in the description of Table control). | | WithNbPages | Prints the number of pages at the bottom of the page. | | WithTitle | Prints the title of the Table control at the top of the page. If the title of Table control is not visible, prints the window title. | | WithAll | Prints the content of the Table content while taking all the options into account (corresponds to WithMultipageColumns + WithDate + WithNbRecords + WithNbPages + WithTitle) |
Remarks Characteristics of print - The print cannot be modified: no other element can be added. The page breaks are automatically checked.
- The total number of pages is not calculated in the following cases:
- if the print affects more than 3000 records.
- if the calculation regarding the total number of pages exceeds 4 seconds on a browsing Table control based on a HFSQL Client/Server data file.
- The print characteristics are as follows:
- If it is printed, the title of the print corresponds to the title of the Table control. The window title is used if no title was specified for the Table control.
- The column titles are printed on each page.
- The print respects the background colors used for the different cells found in the Table control.In order for the print to respect the background colors used for the different cells found in the Table control, call AAFConfigure (or ConfigureAAF) associated with the aafPrintReportOnTable constant as follows:
ConfigureAAF(aafPrintReportOnTable, 1)
- The print does not respect the RTF attributes of the texts found in the Table control.
- The counters, the totals, ... defined for the Table control are not printed. Only a counter for the number of rows found in the Table control can be printed below the control. The caption corresponds to the caption defined for the counter in the characteristics of Table control.
- If it is printed, the date is printed in the top right corner.
- If they are printed, the current page number and the total number of pages are printed in the bottom right corner of the page.
- The horizontal merge of columns is respected, except in the following cases:
- merge with an invisible column.
- merge of columns that "overlay" over 2 pages.
- The images found in the Table control are printed only if the path of the image is specified. The images found in the memos are not printed.
- The print takes into account the writing direction specified by ..TextDirection for the window and/or for the Table control.
Component : wd240etat.dll
This page is also available for…
|
|
|