iSubstBlock (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Substituting the first block of the page header

Substituting the Page Footer block

iChangeSubReportSource

iInitReportQueryConnection

iReportPrintingStatus

Substituting the first block of the page header
Substituting the Page Footer block
Various

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

iSubstBlock (Function)

In french: iSubstBloc

Substitutes one block of the report with another block while the report is printed.

Once iSubstBlock has been run, the following processes will be run when the initial block is printed:

"Before printing" event of the substitution block.
print the substitution block.
"After printing" event of the substitution block.

Versions 15 and later

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See Printing in Linux for more details.

New in version 15

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See Printing in Linux for more details.

This function is now available for WINDEV applications in Linux.

This function is now available for WEBDEV sites in Linux.

Caution: A specific configuration is required to use this function in Linux. See Printing in Linux for more details.

Example

// Substitution of page header
iSubstBlock(PageHeader, Iteration1)
// End of substitution of page header
iSubstBlock(PageHeader, "")

Syntax

iSubstBlock(<Block to substitute> , <New block>)

<Block to substitute>: Character string with or without quotes

Logical name of the block to replace. This name was defined in the report editor, in the block description ("General" tab, "Name" control).

<New block>: Character string with or without quotes

Logical name of the block used for the substitution. This name was defined in the report editor, in the block description.
If this parameter corresponds to an empty string (""), the current substitution for the <Block to substitute> block is canceled.
If this parameter is equal to <Block to substitute>, the current substitution is canceled.

Remarks

Substituting the first block of the page header

To substitute the first block of the page header, iSubstBlock must be used in an initializing event of the report (for example, in one of the events of the document header block or in the "Opening" event of the report). These events will be run before printing this block.

Substituting the Page Footer block

To avoid display problems, the Page Footer block and its substitution block must have the same height.

Various

You will get the same result by performing the following operations:
1. Make the block invisible (..Visible).
2. Use iPrintBlock.
To substitute a Page Footer block, we recommend that you use blocks with the same height.
Versions 19 and later
In most cases, we recommend that you use planes in the report as they are easier to use and to implement (rather than block substitution). See The planes for more details.
New in version 19
In most cases, we recommend that you use planes in the report as they are easier to use and to implement (rather than block substitution). See The planes for more details.
In most cases, we recommend that you use planes in the report as they are easier to use and to implement (rather than block substitution). See The planes for more details.

Related Examples:

Training (WINDEV): WD DuplexPrintout

[ + ] This example presents a solution for duplex printout that can be disabled, which means that the reverse sides may not be printed.
In this example, the general sales conditions will be inserted into a report by using the principle of block substitution.
These general conditions are inserted between each page.
The example allows you to print:
- in duplex mode if the printer supports it,
- on the front side of pre-printed sheets for which the general sales conditions are printed on the back side.

Business / UI classification : Neutral code

Component : wd260etat.dll