BreakAdd (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing breaks

BreakAdd

Presentation

Example

See also

BreakAdd (Function)

In french: RuptureAjoute

Adds a break into a Table control or into a Looper control.

Example

// Add a green break on the date into the Table control
x is Control
x <- BreakAdd(TABLE_Order.COL_DATE, "BrkDate", brkHeader, 50)
x..BrushColor = DarkGreen // Colors the break in green

// Add a break header and footer into the Table control
BreakHeader is Control
BreakFooter is Control
(BreakHeader, BreakFooter) <- BreakAdd(TABLE_Customer.COL_NAME, "BreakHeaderName" + TAB + ...
"BreakFooterName", brkHeaderAndFooter)

Syntax

<Result> = BreakAdd(<Element name> , <Break name> [, <Type of break> [, <Height>]])

<Result>: Control variable

Name of Control variable used to handle the created break. In this case, the assignment must be performed by the '<-' operator.
If <Type of break> corresponds to the brkHeaderAndFooter constant, the function returns 2 controls. The syntax becomes:

(<NameBreakHeaderControl>,<NameBreakFooterControl>) <- ] BreakAdd(<Element name>, ...
<Name of header break> + TAB + <Name of Footer Break>, brkHeaderAndFooter)

<Element name>: Character string (with or without quotes)

Name of element on which the break will be done. It is a Table column or the name of a Looper attribute.

<Break name>: Character string (with quotes)

Name of break to create. This name must not exist in the Table control or in the Looper control.
If <Type of break> corresponds to the brkHeaderAndFooter constant, this parameter has the following format:

<Name of header break> + TAB + <Name of footer break>

<Type of break>: Integer constant

Type of break to create:
brkHeader
(Default value) Adds a break header.
brkFooter Adds a break footer.
brkHeaderAndFooter Adds a break header and footer.

<Height>: Optional integer

Height of break in pixels. The break height is set to 32 pixels by default.

Remarks

The breaks created by BreakAdd can be deleted by BreakDelete.
If the Table or Looper control already contains breaks, the break is created on the next level:

[Existing break header]
[New break header]
Row 1 of table
[New break footer]
[Existing break footer]
BreakAdd cannot be used on:
- The browsing Table and Looper controls in direct access.
- The Vertical Table controls.
In this case, the function fails and a non-fatal error is displayed.

Component : wd240obj.dll