PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Creating a report on TreeView Table control from the report editor
  • Creating a report on TreeView Table control from the report editor
  • Characteristics of report on TreeView Table control
  • Test of the report
  • Printing a report on TreeView Table control
  • Printing a report on TreeView Table control
  • WINDEV and WINDEV Mobile example
  • WEBDEV example
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Report on TreeView Table control
Overview
The report on a TreeView Table control is used to directly print the information displayed in a TreeView Table control found:
  • in a window or page of application. This window or page must be displayed when printing the report.
  • in a window or in an internal page:
    • The window displaying the internal window must be displayed.
    • The page displaying the internal page must be displayed.
A report on TreeView Table control can print:
  • all the rows displayed in the TreeView Table control.
  • the rows selected by the user (for the multi-selection TreeView Table controls where the rows are selected via the [Ctrl] key). This option is not available in WEBDEV.
  • the entire hierarchy.
  • the hierarchy visible in the TreeView Table control.
Note: Only a Treeview Table report can be created on a Treeview Table control.
Creating a report on TreeView Table control from the report editor
The report editor allows you to create a TreeView Table report based on a TreeView Table control. Each row and each column found in the TreeView Table control are displayed in the TreeView Table report.
Once the report is created, the print must be programmed in WLanguage. See Printing a report on TreeView Table control for more details.

Important

Reports & Queries cannot be used to create reports on a TreeView Table control. However, you have the ability to customize the reports on a TreeView Table control created in the standard report editor (color, fonts, size, ...).

Creating a report on TreeView Table control from the report editor

To create a report on TreeView Table control from the report editor:
  1. Click among the quick access buttons.
    • Click "Report" in the wheel that is displayed. The window for creating a new element is displayed: click "Report" then "Report".
    • The wizard for report creation starts.
  2. Choose a "TreeView Table" report.
  3. Select "From a TreeView Table control" and go to the next step.
  4. Specify:
    • the TreeView Table control on which the report will be based. Only the TreeView Table controls found in the windows or pages of current project are proposed.
    • whether only the selected rows must be printed or whether all the control rows must be printed.
  5. Select the items (columns of TreeView Table control) to print and their position (associated block).
  6. Specify whether calculations must be performed on the numeric items.
  7. Specify the format of the sheet on which the report will be printed. The report is printed in A4 format by default.
  8. Select the skin template to use.
  9. Type the name and title of report (name of ".WDE" file corresponding to the report). This name will be used to identify the report in your programs.
    WINDEV You also have the ability to specify whether the report can be modified by the end user in "Reports and Queries".
  10. Validate the report creation.
  11. The report editor automatically proposes to change the format of the report.
  12. Specify the mode for reducing the report size:
    • Versions 19 and later
      Print the report on several pages. In this case, the end user will have to group the pages. See Multi-page print for more details.
      New in version 19
      Print the report on several pages. In this case, the end user will have to group the pages. See Multi-page print for more details.
      Print the report on several pages. In this case, the end user will have to group the pages. See Multi-page print for more details.
    • Use the landscape mode.
    • Reduce the report size. Caution: according to the reduction percentage, the printed report may become unreadable.
  13. The report currently created is displayed in the report editor.
Characteristics of report on TreeView Table control
A report on TreeView Table control corresponds to a report on a Table control with additional characteristics.
The report includes a table. For more details, see:
In the report description, information specific to this type of report can be configured in the "Data" tab:
  • WINDEVWindows Mobile Printed rows: Like for the Table control, you have the ability to specify whether only the selected rows or all the control rows must be printed.
  • Printing the hierarchy: You have the ability to specify whether only the hierarchy displayed in the control must be printed or whether the entire hierarchy must be printed.

Test of the report

The test of a report on a TreeView Table control cannot be run from the report editor because the window or the page containing the TreeView Table control must be opened. To run the test of a report on Treeview Table control, you must:
  • create (if necessary) a button in the window or in the page of TreeView Table control. This button is used to print the report on the TreeView Table control (iPrintReport).
    Case of internal windows or internal pages: If the TreeView Table control is found in an internal window or in an internal page, the button should be created in the internal window/page (and not in the host window/page).
  • run the test of the window containing the TreeView Table control then run the report test (via the button).
    Case of internal windows: the test must be run from the window that is hosting the internal window.
  • run the test of the page containing the TreeView Table control then run the test of the report (via the button).
    Case of internal pages: the test must be run from the page that hosts the internal page.
Printing a report on TreeView Table control

Printing a report on TreeView Table control

A report on TreeView Table control must be printed from the window (or from the page) displaying the TreeView Table control to print. All you have to do is:
  1. Create a button in the window (or in the page) containing the TreeView Table control.
  2. Configure the destination of report print:
  3. Specify the name of report to print with iPrintReport.
Notes:
  • If additional parameters must be passed to the report, these parameters must be specified in iPrintReport, after the name of report to print. See Report with parameters for more details.
  • WINDEVWindows Mobile If the window containing the TreeView Table control, source of report, is opened several times (non-modal opening by OpenChild), the full name of TreeView Table control to print must be passed in parameter to the report. For example:
    // The ..FullName property will contain the window name// that must be opened with an alias to distinguish between each windowiPrintReport(RPT_Customer_TVTable, TVT_Customer..FullName)
    // Opening code of report:
    PROCEDURE RPT_Customer_TVTable(sNameSourceTVTable)
    MyReport..SourceName = NameSourceTVTable
  • WINDEVWindows Mobile ..SelectionOnly is used to find out and modify the records that will be printed in the report: printing all records or the selected records only.
  • ..KeepVisibleHierarchy is used to find out and modify the print mode of hierarchy: printing the entire hierarchy or printing the hierarchy that is visible in the control.

Important

In Reports & Queries, a report can be printed:
  • by starting a print ( ).
  • by running the report test ( ).
Therefore, no programming is required to print the report.
WINDEVReports and QueriesWindows Mobile

WINDEV and WINDEV Mobile example

The information to print is contained in the TreeView Table control named "TVT_CustomerTable" found in the "WIN_Customer" window.
The report to print is named "RPT_TVTable_Customer" and it is printed when clicking the "BTN_Print" button.
In this example, the click code of "BTN_Print" button is as follows:
In WINDEV:
// Open the preview window
iPreview()
// Print the report based on the "TVT_CustomerTable" control
iPrintReport(RPT_TVTable_Customer)
In Windows Mobile:
// Select the printer
iConfigure()
// Print the report based on the "TVT_CustomerTable" control
iPrintReport(RPT_TVTable_Customer)
WEBDEV - Server code

WEBDEV example

The information to print is contained in the Treeview Table control named "TVT_CustomerTable" found in the "PAGE_Customer" page.
The report to print is named "RPT_TVTable_Customer" and it is displayed in a PDF file when clicking the "BTN_Print" button.
In this example, the click code of "BTN_Print" button is as follows:
// Generates a unique file name UniqueFileName is string = fWebDir() + "\" + ... "RPT_TVTable_Customer_" + DateSys() + TimeSys() + ".pdf" // Configures the print destinationiDestination(iPDF, UniqueFileName) // Prints the report based on TVT_CustomerTable controliPrintReport(RPT_TVTable_Customer) // Displays the report in PDF formatFileDisplay(UniqueFileName, "application/pdf")// Deletes the filefDelete(UniqueFileName)
Minimum required version
  • Version 19
This page is also available for…
Comments
Click [Add] to post a comment