TablePrint (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Characteristics of print

See also

CollapseExpand

BuildBrowsingTable

Constants for managing Table, Treeview Table, Looper and List Box controls

FileToMemoryTable

Functions for managing Table controls

TableAddLineWithAnimation

TableCellSelectOccurrence

TableCollapseExpand

TableColumnSelect

TableColumnSelectOccurrence

TableDeleteWithAnimation

TableFormulaDeleteAll

TableInsertLineWithAnimation

TableRestorePositionAndSelection

TableSave

TableSavePositionAndSelection

Characteristics of print

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

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.

Example

// 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)

// Specify the print parameters:
// with preview, in landscape mode
iPreview(i100)
iParameter(iOrientation, iOrientation_Landscape)
// The COL_Column1 column is invisible
TABLE_MyTable[COL_Column1]..Visible = False

// Print the Table control, without the date and with the number of pages
TablePrint(TABLE_MyTable, WithAll - WithDate - WithNbPages)

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.
- 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. Images in 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 : wd260etat.dll