PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Belonging of controls
  • Case of dynamic tabs
  • WLanguage error
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Returns the name of the Nth control found in the specified element. This element must be displayed.
Note: In most cases, we recommend that you use gpwEnumControl that lists all controls directly.
WINDEVWINDEV Mobile The specified element can be a window, a report, a group of controls, a tab, a looper or a supercontrol. The Toolbar controls and the SideBar controls are not supported.
WEBDEV - Server code The specified element can be a page, a report, a group of controls, a looper, a looper break, a cell or a supercontrol.
Versions 15 and later
Android This function is now available for the Android applications.
New in version 15
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
In a loop, this function is used to enumerate the controls found in an element.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android Widget mode.
iPhone/iPad This function is now available for the reports in the iPhone/iPad applications.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android Widget mode.
iPhone/iPad This function is now available for the reports in the iPhone/iPad applications.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android Widget mode.
iPhone/iPad This function is now available for the reports in the iPhone/iPad applications.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
WINDEVReports and QueriesWindows MobileUniversal Windows 10 AppJavaUser code (UMC)
// Name of control 7 in the "WIN_EditWindow" window
ResControl = EnumControl(WIN_EditWindow, 7)
WINDEVReports and QueriesWindows MobileJavaUser code (UMC)
// Fill a combo box with the list of window controls
i is int = 1
ResControl is string
ResControl = EnumControl(WIN_EditWindow, i)
WHILE ResControl <> ""
i++
ListAdd(LIST_ControlList, ResControl)
ResControl = EnumControl(WIN_EditWindow, i)
END
WEBDEV - Server codeAjax
// Name of control 7 in the "PAGE_MyPage" page
ResControl = EnumControl(PAGE_MyPage, 7)
WEBDEV - Server codeAjax
// Fill a combo box with the list of page controls
i is int = 1
ResControl is string
ResControl = EnumControl(PAGE_MyPage, i)
WHILE ResControl <> ""
i++
ListAdd(LIST_ControlList, ResControl)
ResControl = EnumControl(PAGE_MyPage, i)
END
Syntax
<Result> = EnumControl(<"Parent" Object> , <Control Number> [, <Type of Enumeration>])
<Result>: Character string
  • Name of the control found,
  • Empty string ("") if no control was found.
<"Parent" Object>: Character string
Name of the "parent" object (containing the control). This parameter corresponds to the name of a window, looper, looper break, group, tab, supercontrol or report.
If the "parent" object is a tab, the following notation must be used: <Tab name>[<Pane number>]. For example: Tab1[2].
WEBDEV - Server code Name of the "parent" object (containing the control). This parameter corresponds to the name of a page, report, group of controls, looper, looper break, cell or supercontrol.
<Control Number>: Integer
Number of the control whose name is requested. Each control is associated with a number. This number corresponds to:
  • the creation order of the controls (by default) if the type of enumeration is performed by the byCreationOrder constant
  • the tab order (which means the order in which the controls take focus in the "parent" object) if the type of enumeration is performed with the byTabOrder constant.
    The [F5] key is used to view the tab order in the window editor and in the page editor.
<Type of Enumeration>: Optional Integer constant
Order in which the enumeration is performed:
byZOrderEnumeration performed according to the z-order position of the controls, from the lowest one to the highest one.
byCreationOrder
(Default value)
Enumeration performed according to the creation order of controls (in the editor or by ControlClone).
byTabOrderEnumeration performed according to the tab order (TAB key). The controls that cannot be accessed by the TAB key are listed at the end.

WEBDEV - Server code This parameter is not available.
Remarks

Belonging of controls

Only the controls that directly belong to the specified "parent" object are enumerated.
For example, if <"Parent" object> corresponds to the name of a window (or page), EnumControl only works for the controls that directly belong to this window (or to this page). EnumControl cannot be used to retrieve the names of the controls belonging to the tabs or to the supercontrols of this window (or page).
Versions 20 and later
WINDEV

Case of dynamic tabs

If <"Parent" Object> corresponds to the name of a Tab control with dynamic panes, the aliases of the dynamic panes are enumerated.
New in version 20
WINDEV

Case of dynamic tabs

If <"Parent" Object> corresponds to the name of a Tab control with dynamic panes, the aliases of the dynamic panes are enumerated.
WINDEV

Case of dynamic tabs

If <"Parent" Object> corresponds to the name of a Tab control with dynamic panes, the aliases of the dynamic panes are enumerated.

WLanguage error

A WLanguage error occurs if:
  • <Control Number> is negative.
  • <Control Number> is greater than the number of controls found in <"Parent" Object> +1. This is used to avoid the endless loops.
  • <"Parent" Object> is not a window, a page, a report, a group, a tab or a supercontrol.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230vm.dll
Windows Mobile wp230vm.dll
Java wd230java.jar
Linux wd230vm.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment