Count (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

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 options in a menu.

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.
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.
Number of elements in a queue, in a list or in a stack.
Number of occurrences for an element of the associative array.
Number of options in a menu.

<Element used>: Type of element

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

Remarks

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,
menus.