Count (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Table control based on a data file with bouncing scrollbar
Array and associative array
Limit

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Count (Property)

In french: Occurrence

Warning
From version 24, Occurrence is kept for backward compatibility. This property is replaced by Count.

The Count property returns the number of elements in a given set. You can get:

the number of rows in a List Box or Combo Box control.
the number of rows in a Table control. If there is a filter on a column, the Count property returns the number of elements displayed.
the number of rows in a Looper control.
the number of elements in a ListView control.
the number of rows in a Table control column.
the number of options in a Radio Button or Check Box control.
the number of controls in a group of controls.
the number of elements in a TreeView control.
the number of series in a Chart control.
the number of elements in an array, associative array or advanced array (arrays used in the gglxxx variables for example) as well as the number of occurrences for an element of the associative array.
the number of elements in a WLanguage queue, list or stack.
the number of indexed sub-elements in a variant.
the number of panes in a Tab control.
the number of files in an Upload control.
the number of options in a menu.
the number of elements in an Organization Chart control.

The Count property returns:

the number of rows in a List Box, Table, TreeView Table, Looper, Linear Looper, Tab or Combo Box control.
the number of elements in an array or associative array as well as the number of occurrences for an element of the associative array.

Remark: The Count property can be used on Table, List Box, Looper or Combo Box controls based on a data file or populated programmatically.

Example

// Number of elements found in the "TABLE_CustomerTable" control
ResCount = TABLE_CustomerTable.Count

// Number of elements in CustomerArray
CustomerArray is dynamic array
CustomerArray = new dynamic array of 4 by 7 int
Trace("Number of elements: " + CustomerArray.Count)

Syntax

<Result> = <Element used>.Count

<Result>: Integer

Total number of rows found in the specified List Box, Table, Looper or Combo Box control.
Result also available in browser code for WEBDEV.
Number of elements found in the specified ListView control.
Number of rows found in the specified Table column.
Number of options found in the specified Check Box or Radio Button control.
Number of controls found in the specified group of controls.
Number of elements in a TreeView control.
Number of series in a Chart control.
Number of panes in a Tab control.
Number of elements in an array or associative array.
Result also available in browser code for WEBDEV.
Number of elements in a queue, in a list or in a stack.
Number of occurrences for an element of the associative array.
Result also available in browser code for WEBDEV.
Number of files in an Upload control.
The Count property must be used in the "Receiving the files uploaded from..." process. In the other cases, this property returns 0.
Number of options in a menu.
Number of elements in an Organization Chart control.

<Element used>: Type of element

Name of the element to use (WLanguage control or variable).

Remarks

Table control based on a data file with bouncing scrollbar

In a Table control based on a data file with a continuous scrollbar, the Count property returns the number of rows displayed in the Table control and not the number of records in the associated data file.

Array and associative array

The Count property is used to:

Find out the number of elements in an array or in an associative array.
Example:

// Associative array of integers
// indexed on strings and with duplicates
aaIDPerCustomer is associative array of int
// Add the identifier of customer "A"
aaIDPerCustomer["A"] = 55
// Add the identifier of customer "B"
aaIDPerCustomer["B"] = 321
// Add the identifier of customer "A"
aaIDPerCustomer["A"] = 56

Trace("Nb elements: " + aaIDPerCustomer.Count)
// Displays 2 (ignores the duplicates)
Finding out the number of occurrences for an element in an associative array. This property is very useful for an associative array with duplicates.
Example:

// Associative array of integers
// indexed on strings and with duplicates
aaIDPerCustomer is associative array of int
// Add the identifier of customer "A"
aaIDPerCustomer["A"] = 55
// Add the identifier of customer "B"
aaIDPerCustomer["B"] = 321
// Add the identifier of customer "A"
aaIDPerCustomer["A"] = 56

Trace("Nb elements: " + aaIDPerCust["A"].Count)
// Displays 1

Limit

The Count property applies only to:

List Box and ListView controls,
Table and TreeView Table controls,
Looper controls,
Combo Box controls,
TreeView controls,
Check Box controls,
Radio Button controls,
columns of Table controls, columns of TreeView Table controls,
Tab controls,
groups of controls,
Chart controls,
arrays, associative arrays,
queues, stacks and lists,
TreeMap controls.
Upload controls.
menus.
Organization Chart controls.

The Count property applies only to the following elements:

Check Box controls.
Radio Button controls.
List Box controls.
Combo Box controls.
TreeView controls.
Tab controls.
Table controls.
column of Table controls.
queues, stacks and lists.