Returns the index of the break header and footer for a given break in a Table control.
The index of the break header for a given break also corresponds to the index of the first row in this break.
The index of the break footer for a given break also corresponds to the index of the last row in this break.
HeaderIndex is int
// Retrieves the index of the break header for the selected row
HeaderIndex = TableBreakIndex(BRK_BreakHeader)
// Adds a row into the Table control
RowIndex is int
RowIndex = TableAddLine(TABLE_Articles, ProductName, ...
SupplierName, UnitPrice)
// Retrieves the index of the break header for the added row
HeaderIndex = TableBreakIndex(BRK_BreakHeader, RowIndex)
// Fixes the value of the text in the break
TABLE_Articles[HeaderIndex].STC_Supplier = SupplierName
Syntax
<Result> = TableBreakIndex(<Break header/footer> [, <Index>])
<Result>: Integer
- Index of the break header/footer in the break containing the row whose index is <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: - <Name of break header/footer>.
- <Table 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 break header/footer in the break containing the current row is returned.
Remarks
Use conditions
TableBreakIndex can be used on a Table control based on a data file or populated programmatically.
It is recommended to call TableBreakIndex once the content of the Table control is entirely displayed. Otherwise, the indices returned by TableBreakIndex may not correspond to the actual indices displayed in the control
Business / UI classification: UI Code