<Looper>.BreakIndex (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Looper functions

Use conditions
Using the <Looper>.BreakIndex function

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Looper>.BreakIndex (Function)

In french: <Zone répétée>.IndiceRupture

Warning
From version 28 (75), .BreakSubscript is kept for backward compatibility. This function has been replaced with <Looper>.BreakIndex.

Returns the index of the break header and footer for a given break in a Looper control:

The index of the header for a given break also corresponds to the index of the first row in this break.
The index of the footer for a given break also corresponds to the index of the last row in this break.

Example

// The LOOP_Invoices Looper control lists the invoices of each customer
// A break is performed for each customer
// The break footer contains the TotalInvoice control
// linked to the ATT_Total attribute
// This control displays the total of all invoices for each customer
MyRow is int = 1 // Beginning of the Looper control
BreakHeader is int // Index of break header
BreakFooter is int // Index of break footer
Index is int // Index of rows
Total is int // Total for each break

// Calculate the totals for the entire Looper control
WHILE MyRow <= LOOP_Invoices.Count
// Index of the current break
BreakHeader = BRK_CustHeader.BreakIndex(MyRow)
BreakFooter = BRK_CustFooter.BreakIndex(MyRow)

// Browse the rows found in the current break
// to calculate the total
FOR Index = BreakHeader TO BreakFooter
Total += ATT_Value[Index]
END

// Assign the total
ATT_Total[BreakFooter] = Total

// Go to the next break
MyRow = BreakFooter + 1
END

Syntax

<Result> = <Break header/footer>.BreakIndex([<Index>])

<Result>: Integer

Index of the header/footer break specified in the break containing the row at index <Index>,
0 if an error occurs. To get more details on the error, use ErrorInfo with the errMessage constant.

<Break header/footer>: Control name

Name of the break header or footer to be used.
This parameter can correspond to:
the name of the break header or break footer directly.
<Name of Looper control>.<Name of break header/footer>

<Index>: Optional integer

Index of one of the rows in the desired break.
If this parameter is not specified, the index of the header/footer break specified in the break containing the current row is returned.

Remarks

Use conditions

<Looper>.BreakIndex can be used on:

a Looper control based on a data file,
a Looper control populated programmatically.

This function is not available for Linear Looper controls. This function is available for Looper controls in browser mode only.

This function is available for Looper controls in Ajax mode, Looper controls in classic mode and Linear Looper controls.

Using the <Looper>.BreakIndex function

It is recommended to call <Looper>.BreakIndex once the Looper control is displayed in its entirety. Otherwise, the indices returned by <Looper>.BreakIndex may not correspond to the actual indices displayed in the Looper control.

Component: wd280obj.dll