ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Table functions
  • Use conditions
  • Row characteristics
  • Position of the new row
  • Limits: Maximum number of lines displayed
  • Miscellaneous
  • Adding images
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Adds a row in:
  • a Table control,
  • a TreeView Table control,
Note: It is recommended to use <Table>.AddLine. <Table>.AddLine is used to add:
  • TAB characters into the columns,
  • all types of values into the columns,
  • UNICODE data automatically and without conversion.
Example
// Ajout de "Dubois", "Pierre" et "21/06/72"
// à la fin du champ "TABLE_TableClient"
ResAjout = TABLE_TableClient.Ajoute("Dubois" + TAB + "Pierre" + TAB + "21/06/72")
Syntax
<Result> = <Table control>.Add([<Row>])
<Result>: Boolean
  • True if the element was added,
  • False otherwise.
<Table control>: Control name
Name of the control to be used. This control can correspond to:
  • a Table control.
  • a TreeView Table control.
<Row>: Optional character string
Row to add. This row has the following format:
<Element of column 1> + TAB + <Element of column 2> + TAB + ...

If this parameter is not specified, an empty row is added into the control. For a data-bound control, the default values defined in the linked data file are taken into account.
Remarks

Use conditions

<Table>.Add can be used on:
  • Table or TreeView Table controls based on a data file.
  • Table or TreeView Table controls populated programmatically.
  • single-selection or multi-selection controls.
AndroidiPhone/iPad Table controls based on a data file are not available in edit mode. <Table>.Add cannot be used on Table controls based on a data file.

Row characteristics

  • Each added element is converted into the type of the relevant column.
  • If you don't want to specify a value for an element, use an empty string ("") or 0 (depending on the column type). For example:
    TABLE_TableClient.Ajoute("Dubois" + TAB + "Pierre" + TAB + "" + TAB + "21/06/72")
  • If an element corresponds to the result of a calculation, enclose the numerical expression in brackets. For example:
    TABLE_TableCalcul.Ajoute((53+29) + TAB + (83-21))

Position of the new row

By default, the row is added at the end of the rows displayed by the control.
Special case:
  • If the control is sorted by <Table>.Sort, the added row is positioned in the control according to the current sort.
  • If the control is sorted by the user, the sort is ignored when inserting the row. The row is added at the end of control.

Limits: Maximum number of lines displayed

The maximum number of rows that can be displayed in a TreeView Table control or hierarchical Table is limited only by available RAM (theoretical maximum: 2 billion rows).
However, we do not advise you to use large Table or TreeView Table controls for performance and user-friendliness reasons (time required to fill the control for example).

Miscellaneous

  • To add a row at a specific position in a Table or TreeView Table control, use <Table>.InsertLine.
  • If the added row is the first row of the control, the added row becomes the current row.

Adding images

To add an image to a Table or TreeView Table control:
    Note: To correctly display the added image, the column must be of type Image.
    Component: wd300obj.dll
    Minimum version required
    • Version 23
    This page is also available for…
    Comments
    Click [Add] to post a comment

    Last update: 09/18/2024

    Send a report | Local help