Troubleshooting Qt Applications

Issues with simulating user actions in Qt 6 applications in High-DPI systems

Issues with getting access to the application’s objects

The context menu items and their subitems may be recognized as siblings.

A control’s popup menu may be recognized incorrectly.

TestComplete may fail to simulate recorded user actions over a Qt 6 application in High-DPI systems.

For TestComplete to be able to access objects in a tested Qt application, their properties and methods, the following modules of the application must keep their original name. In other words, do not rename the following modules:

• QtNGui.dll
• QtNCore.dll
• QtNWidgets.dll

Where N is the used Qt version: 5 or 6.

Also, we do not recommend that you modify these files. For example, your tested Qt application developers may delete unused functions from these files to reduce their size. However, TestComplete may use the deleted functions to access the application’s objects. If the required functions are deleted, TestComplete will not be able to recognize some objects in the application.

For example, suppose the tested Qt application has a QtToolButton control that invokes a context menu upon a click, and each context menu item has a number of subitems. When recording a test with TestComplete you may face the following problem: the context menu items and their subitems will be recognized as siblings, so, clicks over them will be recorded as clicks over items of the same level. This behavior is caused by the following reason: invoked subitems are not child items of the button’s context menu items to which they correspond (their Parent property returns an empty object). In order for tests to be recorded and played back correctly, the tested application’s developer must associate the context menu items with the appropriate subitems in the application.

Due to the specifics of Qt applications, it is impossible to determine which menu is a control’s popup menu. Because of this, TestComplete considers the first child menu of a control as its popup menu. If the control has more than one child menu, TestComplete may recognize the popup menu incorrectly. To avoid this, you can use one of the following solutions:

• Make sure the popup menu is the only child menu of the control.

• Use the QtObject method to refer to the popup menu. To avoid wrong recognition, you should specify the menu name in the windowsTitle property in your Qt application:

  C++

  Copy Code

  C++

  pMenuObj->setWindowTitle("MyWndPopupMenuName");

  In this case, you can get the popup menu by using code that looks like the following:

  JavaScript, JScript

  Python

  VBScript

  DelphiScript

  C++Script, C#Script

  Copy Code

  JavaScript, JScript

  Aliases.TestApplication.QtObject("QMenu", "MyWndPopupMenuName").QtMenu

  Python

  Aliases.TestApplication.QtObject("QMenu", "MyWndPopupMenuName").QtMenu

  VBScript

  Aliases.TestApplication.QtObject("QMenu", "MyWndPopupMenuName").QtMenu

  DelphiScript

  Aliases.TestApplication.QtObject('QMenu', 'MyWndPopupMenuName').QtMenu

  C++Script, C#Script

  Aliases["TestApplication"]["QtObject"]("QMenu", "MyWndPopupMenuName")["QtMenu"]