Did this article resolve your question/issue?


Your feedback is appreciated.

Please tell us how we can make this article more useful. Please provide us a way to contact you, should we need clarification on the feedback provided or if you need further assistance.

Characters Remaining: 1025



What is the WIDGET-ID attribute?

« Go Back


Article Number000026872
EnvironmentProduct: OpenEdge
Version: 10.1x, 10.2x, 11.x
OS: All supported versions
Question/Problem Description
What is the WIDGET-ID attribute?

What is the ABL WIDGET-ID attribute, and how can it be used?
Steps to Reproduce
Clarifying Information
Automated test tools require some means of identifying each widget in a GUI in a way that does not change from session to session, or when the layout of a window or form is changed.
Error Message
Defect/Enhancement Number
Beginning in OpenEdge 10.1A, the WIDGET-ID attribute is available on all ABL widgets for the purpose of identifying each widget to automated test tools at run time.
The value of the WIDGET-ID attribute must be an even INTEGER value between 2 and 65534 inclusive, and it must be unique across all widget IDs in a window. The widget ID value of any given widget remains the same across ABL sessions, unless the value of the attribute is purposely changed in code. This allows a third-party automated test tool to identify the same widget consistently each time the tool run the tool with a given application.
To enable application-defined widget IDs in an ABL GUI application, specify the Use Widget ID (-usewidgetid) startup parameter. If -usewidgetid is not specified, the AVM ignores any WIDGET-ID attribute settings and generates its own widget IDs. In this case, querying the WIDGET-ID attribute returns the Unknown value (?).
To make use of the WIDGET-ID attribute, third-party automated test tools must be aware of the concept of a widget ID and provide some means of indicating to the tool that the WIDGET-ID attribute is the unique identifier for the widget. Many test tools have this capability, but some do not; newer tools are more likely to be able to make use of a widget ID.
Progress Software Corporation does not recommend specific third-party software, including automated test tools.

References to Other Documentation:
OpenEdge Development: ABL Reference, "ABL Reference > Handle Attributes and Methods Reference > WIDGET-ID attribute"
Progress Dynamics addenda, "Widget IDs for ADM2 and Progress Dynamics"
Application Development Environment (ADE) Addenda, "Widget IDs for ADM2 and Progress Dynamics"

Progress Article(s):
000027819, "Information on widget ID's is not in "Programming Interfaces""
Last Modified Date9/13/2015 5:12 AM