PC SOFT

AYUDA EN LÍNEA
DE WINDEV, WEBDEV Y WINDEV MOBILE

  • Overview
  • Adding a break
  • Adding a break
  • Break header and footer
  • Image of break buttons
  • Handling the controls found in the break headers and footers
  • Initializing the controls found in the break headers and footers
  • Retrieving the value of controls found in the break headers and footers
  • Automatic calculations in the looper breaks
  • Handling the break headers and footers by programming
  • Initializing the break headers and footers
  • Functions associated with break headers and footers
  • Properties associated with the break headers and footers
  • Managing breaks in the Looper controls by programming
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Otros
Procedimientos almacenados
Break in a Looper control
Overview
A break in a looper is used to group the data corresponding to one or more arguments.
For example, you can list:
  • the customers by country and by city,
  • the invoices per customer,
  • the products according to their family and sub-family, ...
The breaks in the loopers are available for:
  • The browsing Looper controls loaded in memory.
  • The memory Looper controls.
  • Versiones 17 y posteriores
    WEBDEV - Código ServidorWEBDEV - Código Navegador the Looper controls in Standard, Ajax and Browser mode.
    Nueva funcionalidad versión 17
    WEBDEV - Código ServidorWEBDEV - Código Navegador the Looper controls in Standard, Ajax and Browser mode.
    WEBDEV - Código ServidorWEBDEV - Código Navegador the Looper controls in Standard, Ajax and Browser mode.
Versiones 20 y posteriores
WINDEV Notes:
Nueva funcionalidad versión 20
WINDEV Notes:
WINDEV Notes:
Versiones 17 y posteriores
WINDEV MobileiPhone/iPad The breaks in the loopers are now available for the iPhone/iPad applications.
WINDEV MobileAndroid The breaks in the loopers are now available for the Android applications.
WEBDEV - Código Navegador The breaks in the loopers are now available for the Browser loopers.
Android The breaks in the loopers are not available in the multi-column loopers.
Nueva funcionalidad versión 17
WINDEV MobileiPhone/iPad The breaks in the loopers are now available for the iPhone/iPad applications.
WINDEV MobileAndroid The breaks in the loopers are now available for the Android applications.
WEBDEV - Código Navegador The breaks in the loopers are now available for the Browser loopers.
Android The breaks in the loopers are not available in the multi-column loopers.
WINDEV MobileiPhone/iPad The breaks in the loopers are now available for the iPhone/iPad applications.
WINDEV MobileAndroid The breaks in the loopers are now available for the Android applications.
WEBDEV - Código Navegador The breaks in the loopers are now available for the Browser loopers.
Android The breaks in the loopers are not available in the multi-column loopers.
Adding a break

Adding a break

To add a break into a Looper control:
  1. Display the description window of the Looper control ("Description" from the popup menu).
  2. In the "Content" tab, click Break button. The window for break management is displayed:
    Defining the breaks
  3. Select the item or the attribute on which a break must be performed. Several items and/or attributes can be selected in order to implement several breaks.
    The suggested items and attributes depend on the type of looper:
    • In a Looper control linked to a data file:
      • automatic browse: the search item, the attributes linked to this search item and the attributes linked to no item are proposed. If the search item corresponds to a composite key, the components of this composite key, the attributes linked to these components and the attributes linked to no item are proposed.
      • programmed browse: the items of the data file, the attributes linked to these items and the attributes linked to no item are proposed.
    • In a Looper control linked to a query:
      • automatic browse: the search item, the attributes linked to this search item and the attributes linked to no item are proposed. If the search item is not specified ("<Automatic>" option), the sorted query items, the attributes linked to these items and the attributes linked to no item are proposed.
      • programmed browse: the query items, the attributes linked to these items and the attributes linked to no item are proposed.
    • In a memory looper, all looper attributes are proposed.
  4. Validate the window for break management.
  5. The breaks will be performed according to the order in which they are displayed in the table of breaks found in the "Content" tab of the looper description. Modify (if necessary) this order via the arrow buttons found on the right of the table.
  6. Versiones 17 y posteriores
    WINDEVWindows Specify whether the breaks must be "Breaks with collapsed/expanded". If this option is checked, a "+ /-" button is automatically added into the break header. This button will allow the user to collapse or expand the break. Specifies the operating mode of breaks:
    • WINDEVWINDEV MobileWindowsLinuxAndroidiPhone/iPad whether breaks must be "Breaks with collapsed/expanded". If this option is checked, a "+ /-" button is automatically added into the break header. This button will allow the user to collapse or expand the break.
    • WEBDEV - Código ServidorPHP whether breaks must be "Collapsable/Expandable breaks via a simple click in the background". If this option is checked, the user will have the ability to click in the break header to collapse or expand the break according to his own requirements.
    Nueva funcionalidad versión 17
    WINDEVWindows Specify whether the breaks must be "Breaks with collapsed/expanded". If this option is checked, a "+ /-" button is automatically added into the break header. This button will allow the user to collapse or expand the break. Specifies the operating mode of breaks:
    • WINDEVWINDEV MobileWindowsLinuxAndroidiPhone/iPad whether breaks must be "Breaks with collapsed/expanded". If this option is checked, a "+ /-" button is automatically added into the break header. This button will allow the user to collapse or expand the break.
    • WEBDEV - Código ServidorPHP whether breaks must be "Collapsable/Expandable breaks via a simple click in the background". If this option is checked, the user will have the ability to click in the break header to collapse or expand the break according to his own requirements.
    WINDEVWindows Specify whether the breaks must be "Breaks with collapsed/expanded". If this option is checked, a "+ /-" button is automatically added into the break header. This button will allow the user to collapse or expand the break. Specifies the operating mode of breaks:
    • WINDEVWINDEV MobileWindowsLinuxAndroidiPhone/iPad whether breaks must be "Breaks with collapsed/expanded". If this option is checked, a "+ /-" button is automatically added into the break header. This button will allow the user to collapse or expand the break.
    • WEBDEV - Código ServidorPHP whether breaks must be "Collapsable/Expandable breaks via a simple click in the background". If this option is checked, the user will have the ability to click in the break header to collapse or expand the break according to his own requirements.
  7. Validate.
Notes:
  • Breaks can be created in the single-column loopers and in the multicolumn loopers.
  • Versiones 18 y posteriores
    WINDEV A break header can be always visible. In this case, during the scroll, the bar of the break will not be moved. In order for a break header to be always visible:
    • Select the break header and display its description ("Description" from the popup menu).
    • In the "GUI" tab, check "Break header always visible".
    Nueva funcionalidad versión 18
    WINDEV A break header can be always visible. In this case, during the scroll, the bar of the break will not be moved. In order for a break header to be always visible:
    • Select the break header and display its description ("Description" from the popup menu).
    • In the "GUI" tab, check "Break header always visible".
    WINDEV A break header can be always visible. In this case, during the scroll, the bar of the break will not be moved. In order for a break header to be always visible:
    • Select the break header and display its description ("Description" from the popup menu).
    • In the "GUI" tab, check "Break header always visible".
    WINDEVAndroidiPhone/iPad A break header can be always visible. In this case, during the scroll, the bar of the break will not be moved. In order for a break header to be always visible:
    • Select the break header and display its description ("Description" from the popup menu).
    • In the "GUI" tab, check "Break header always visible".

Break header and footer

When adding a new break, a break header and a break footer are automatically added to the looper. If the looper includes several breaks, there will be as many break headers and break footers as the number of breaks.
The characteristics of these break headers and footers (name, visibility, background color, ...) can be modified in their description window ("Description" from the popup menu).
Each break header and break footer is associated with the "Row display" process. This process is run when a new break header or break footer is displayed in the looper.
These break headers and footers can contain controls. These controls can be handled by programming.
Versiones 16 y posteriores
WINDEVWindowsLinux The sums, averages and counts are automatic in the looper breaks. The controls found in the break headers and footers can display these calculations. See automatic calculations in the looper breaks for more details.
Nueva funcionalidad versión 16
WINDEVWindowsLinux The sums, averages and counts are automatic in the looper breaks. The controls found in the break headers and footers can display these calculations. See automatic calculations in the looper breaks for more details.
WINDEVWindowsLinux The sums, averages and counts are automatic in the looper breaks. The controls found in the break headers and footers can display these calculations. See automatic calculations in the looper breaks for more details.

Image of break buttons

To modify the image of break buttons:
  1. Display the description window of the Looper control ("Description" from the popup menu).
  2. A break is defined in the "Content" tab.
  3. In the "Style" tab, select the "Break, border in creation" element.
  4. Click the "Plus/Minus image of breaks" button.
  5. In the area that is displayed, enter the path of the image for the break button. This image is an image with 2 states (plus and minus) in 24 x 12 format.
    Customizing the break buttons
Handling the controls found in the break headers and footers

Initializing the controls found in the break headers and footers

To initialize the controls found in the break headers and footers:
  • handle each control found in all the break headers and footers:
    <Control Name> .. <Property Name> = <Value>
    or
    <Looper Name>.<Name of Break Header/Footer>.<Control Name>..<Property Name> = <Value>
    If <Property Name> corresponds to ..Value, the value of the specified control for the current row is modified
  • handle each control found in a given break:
    <Looper Name>[<Subscript>].<Control Name>..<Property Name> = <Value>
    <Subscript> must correspond to one of the rows found in the specified break.
  • handle each attribute found in all the break headers and footers:
    <Attribute Name> = <Value>
    The property associated with <Attribute Name> will be initialized.
  • handle each attribute of a given break:
    <Attribute Name>[<Subscript>] = <Value>
    The property associated with <Attribute Name> will be initialized.
    <Subscript> must correspond to one of the rows found in the specified break.
Note: These code lines must be found in the "Display process of a row found in the break header/footer".

Retrieving the value of controls found in the break headers and footers

To retrieve the value of controls found in the break headers and footers:
  • handle each control found in the current break:
    <Value> = <Control Name>..<Property Name>
    or
    <Value> = <Looper Name>.<Break Header/Footer Name>.<Control Name>..<Property Name>
  • handle each control found in a given break:
    <Value> = <Looper Name>[<Subscript>].<Control Name>..<Property Name>
    <Subscript> must correspond to one of the rows found in the specified break.
  • handle each attribute found in all the break headers and footers:
    <Value> = <Attribute Name>
    The value of the property associated with <Attribute Name> will be retrieved.
  • handle each attribute of a given break:
    <Value> = <Attribute Name>[<Subscript>]
    The value of the property associated with <Attribute Name> will be retrieved.
    <Subscript> must correspond to one of the rows found in the specified break.
Note: These code lines must be found in the "Display process of a row found in the break header/footer".
Versiones 16 y posteriores
WINDEV
Automatic calculations in the looper breaks
You have the ability to perform automatic calculations (sum, count and average) in the break headers and footers.
To implement the automatic calculations:
  1. Insert a Static control or an edit control into the break header and footer.
  2. Display the description window of control ("Description" from the popup menu).
  3. In the "GUI" tab, in the "In a break, display" area, click the "No calculation" link or click the calculation description (if an automatic calculation was already defined). The description window of an automatic calculation is displayed.
  4. Select the calculation to perform. You can choose to:
    • "The sum of": the control will display the sum per break.
    • "The average of": the control will display the average on the break.
    • "The number (count) of": the control will count the number of elements per break.
  5. Select the element on which the calculation must be performed. The calculation can be performed on:
    • A control: the calculation will be performed on the value property of control.
    • An attribute of the looper: the calculation will be performed by using the attribute property.
    • An item of the data file (for the browsing loopers).
  6. Validate.
Tips:
  • Don't forget to modify the input mask of the control that displays the calculation according to the type of calculated information.
  • Don't hesitate to use the "eye magnet" technology on the edit controls that display calculations in the breaks. This gives you the ability you to highlight a calculation (displaying an insufficient turnover in red for example).
Nueva funcionalidad versión 16
WINDEV
Automatic calculations in the looper breaks
You have the ability to perform automatic calculations (sum, count and average) in the break headers and footers.
To implement the automatic calculations:
  1. Insert a Static control or an edit control into the break header and footer.
  2. Display the description window of control ("Description" from the popup menu).
  3. In the "GUI" tab, in the "In a break, display" area, click the "No calculation" link or click the calculation description (if an automatic calculation was already defined). The description window of an automatic calculation is displayed.
  4. Select the calculation to perform. You can choose to:
    • "The sum of": the control will display the sum per break.
    • "The average of": the control will display the average on the break.
    • "The number (count) of": the control will count the number of elements per break.
  5. Select the element on which the calculation must be performed. The calculation can be performed on:
    • A control: the calculation will be performed on the value property of control.
    • An attribute of the looper: the calculation will be performed by using the attribute property.
    • An item of the data file (for the browsing loopers).
  6. Validate.
Tips:
  • Don't forget to modify the input mask of the control that displays the calculation according to the type of calculated information.
  • Don't hesitate to use the "eye magnet" technology on the edit controls that display calculations in the breaks. This gives you the ability you to highlight a calculation (displaying an insufficient turnover in red for example).
WINDEV
Automatic calculations in the looper breaks
You have the ability to perform automatic calculations (sum, count and average) in the break headers and footers.
To implement the automatic calculations:
  1. Insert a Static control or an edit control into the break header and footer.
  2. Display the description window of control ("Description" from the popup menu).
  3. In the "GUI" tab, in the "In a break, display" area, click the "No calculation" link or click the calculation description (if an automatic calculation was already defined). The description window of an automatic calculation is displayed.
  4. Select the calculation to perform. You can choose to:
    • "The sum of": the control will display the sum per break.
    • "The average of": the control will display the average on the break.
    • "The number (count) of": the control will count the number of elements per break.
  5. Select the element on which the calculation must be performed. The calculation can be performed on:
    • A control: the calculation will be performed on the value property of control.
    • An attribute of the looper: the calculation will be performed by using the attribute property.
    • An item of the data file (for the browsing loopers).
  6. Validate.
Tips:
  • Don't forget to modify the input mask of the control that displays the calculation according to the type of calculated information.
  • Don't hesitate to use the "eye magnet" technology on the edit controls that display calculations in the breaks. This gives you the ability you to highlight a calculation (displaying an insufficient turnover in red for example).
Handling the break headers and footers by programming

Initializing the break headers and footers

To initialize the break headers and footers, use the following syntax:
<Name of Break Header/Footer>..<Property Name> = <Value>
Note: These code lines must be found in the "Display process of a row found in the break header/footer".

Functions associated with break headers and footers

The following functions are associated with the break headers and footers:
Versiones 10 y posteriores
LooperBreakSubcript
Nueva funcionalidad versión 10
LooperBreakSubcript
LooperBreakSubcript
Devuelve el índice del ruptura encabezado y pie de página para un dado ruptura en un control Looper.
Versiones 17 y posteriores
LooperCollapse
Nueva funcionalidad versión 17
LooperCollapse
LooperCollapse
%00000012% %00000012%.
Versiones 17 y posteriores
LooperCollapseAll
Nueva funcionalidad versión 17
LooperCollapseAll
LooperCollapseAll
%00000012% %00000012%.
Versiones 17 y posteriores
LooperCollapseExpand
Nueva funcionalidad versión 17
LooperCollapseExpand
LooperCollapseExpand
%00000016% %00000016%: En un dado fila de un control Looper,
  • colapsa a (si ruptura se expande).
Versiones 17 y posteriores
LooperExpand
Nueva funcionalidad versión 17
LooperExpand
LooperExpand
%00000012% %00000012%.
Versiones 17 y posteriores
LooperExpandAll
Nueva funcionalidad versión 17
LooperExpandAll
LooperExpandAll
%00000012% %00000012%.

Properties associated with the break headers and footers

Several properties are used to handle the breaks by programming, especially:
Colapsado...colapsado está acostumbrado:
  • averiguar o definir el status (colapsado o desglosado) que se utilizará cuando se añadan líneas en una control Tabla TreeView.
  • averiguar o modificar el status colapsado/expandido para:
    • las rupturas de un control Tabla,
    • las rupturas de un control Looper,
    • a control Cajón de navegación,
    • a control Cinta de opciones,
    • a control Barra de navegación.
    • a control Tabla dinámica en a reporte.
To find out the entire list of available properties, see Properties available for the breaks (Looper).
Versiones 22 y posteriores
WINDEV
Managing breaks in the Looper controls by programming
The following functions are used to create and handle breaks in the Looper controls:
Versiones 22 y posteriores
BreakAdd
Nueva funcionalidad versión 22
BreakAdd
BreakAdd
Adds a break into a Table control or into a Looper control.
Versiones 22 y posteriores
BreakDelete
Nueva funcionalidad versión 22
BreakDelete
BreakDelete
Borra a ruptura de un control Tabla o de un control Looper.
Versiones 22 y posteriores
BreakDeleteAll
Nueva funcionalidad versión 22
BreakDeleteAll
BreakDeleteAll
Borra todas las pausas de un control Tabla o de uncontrol Looper...
Adding a break into a looper is performed by BreakAdd. The created break corresponds to a Control variable that can be handled by the same WLanguage properties as a break created in the editor.
Nueva funcionalidad versión 22
WINDEV
Managing breaks in the Looper controls by programming
The following functions are used to create and handle breaks in the Looper controls:
Versiones 22 y posteriores
BreakAdd
Nueva funcionalidad versión 22
BreakAdd
BreakAdd
Adds a break into a Table control or into a Looper control.
Versiones 22 y posteriores
BreakDelete
Nueva funcionalidad versión 22
BreakDelete
BreakDelete
Borra a ruptura de un control Tabla o de un control Looper.
Versiones 22 y posteriores
BreakDeleteAll
Nueva funcionalidad versión 22
BreakDeleteAll
BreakDeleteAll
Borra todas las pausas de un control Tabla o de uncontrol Looper...
Adding a break into a looper is performed by BreakAdd. The created break corresponds to a Control variable that can be handled by the same WLanguage properties as a break created in the editor.
WINDEV
Managing breaks in the Looper controls by programming
The following functions are used to create and handle breaks in the Looper controls:
Versiones 22 y posteriores
BreakAdd
Nueva funcionalidad versión 22
BreakAdd
BreakAdd
Adds a break into a Table control or into a Looper control.
Versiones 22 y posteriores
BreakDelete
Nueva funcionalidad versión 22
BreakDelete
BreakDelete
Borra a ruptura de un control Tabla o de un control Looper.
Versiones 22 y posteriores
BreakDeleteAll
Nueva funcionalidad versión 22
BreakDeleteAll
BreakDeleteAll
Borra todas las pausas de un control Tabla o de uncontrol Looper...
Adding a break into a looper is performed by BreakAdd. The created break corresponds to a Control variable that can be handled by the same WLanguage properties as a break created in the editor.
Versión mínima requerida
  • Versión 10
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario