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.
Versions 19 and later
the number of indexed sub-elements in a variant.
New in version 19
the number of indexed sub-elements in a variant.
the number of indexed sub-elements in a variant.
the number of panes in a Tab control.
Versions 16 and later
the number of options in a menu.
New in version 16
the number of options in a menu.
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.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store apps mode.

New in version 18

This property is now available in Windows Store apps mode.

Versions 20 and later

This property is now available for Table controls and table columns in Android and iPhone/iPad applications.

New in version 20

This property is now available for Table controls and table columns in Android and iPhone/iPad applications.

Versions 21 and later

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

This property is now available for Queues, Stacks and Lists.

New in version 21

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

This property is now available for Queues, Stacks and Lists.

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

This property is now available for Queues, Stacks and Lists.

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.
Versions 16 and later
Number of options in a menu.
New in version 16
Number of options in a menu.
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,
Versions 16 and later
menus.
New in version 16
menus.
menus.