ADTF  3.18.1
IQtXSystemabstract

Interface definition for the ADTF XSystem based on Qt. More...

Inheritance diagram for IQtXSystem:
[legend]

Classes

class  IWindow
 IWindow interface defintion for to. More...
 

Public Member Functions

 ADTF_IID (IQtXSystem, "qt_xsystem.ant.services.adtf.iid")
 interface id for adtf::ucom::ant::ucom_cast
 
virtual tResult CreateWindow (IWindow &oWindow)=0
 Create and register a window to the XSystem. More...
 
virtual tResult DestroyWindow (IWindow &oWindow)=0
 Destroy and unregister a window from the XSystem. More...
 
- Public Member Functions inherited from IObject
 ADTF_IID (IObject, "object.ant.ucom.adtf.iid")
 Marks the IObject to be castable with the ucom_cast() More...
 

Protected Member Functions

 ~IQtXSystem ()=default
 protected DTOR
 
- Protected Member Functions inherited from IObject
 ~IObject ()=default
 Protected destructor --> Use implemented Destroy() instead of delete!
 

Detailed Description

Interface definition for the ADTF XSystem based on Qt.

Use this interface to create your own displays within the Qt5 ADTF XSystem UI Service.

Since Qt is NOT binary compatible between Release and Debug versions the QWidget class of Qt is used to provide Consider Basics how to use it. A Default implementation is provided via Qt5 ADTF XSystem UI Service.

See also
Basics, Qt5 ADTF XSystem UI Service

Definition at line 42 of file qtxsystem_intf.h.

Member Function Documentation

◆ CreateWindow()

virtual tResult CreateWindow ( IWindow oWindow)
pure virtual

Create and register a window to the XSystem.

CreateWindow is a blocking call for window creation and can be called within any context. Depending on the implementation the IWindow::Create method to pWindow will be called. The implementation has to make sure the window creation is done only within the main message queue thread. Otherwise it may fail.

Parameters
[in]oWindowWindow implementation. Consider adtf::ui::riddler::cQtWindow.
Returns
Usually this is the return value of the resulting IWindow::Destroy method.
See also
IWindow::Create, adtf::ui::riddler::cQtWindow

◆ DestroyWindow()

virtual tResult DestroyWindow ( IWindow oWindow)
pure virtual

Destroy and unregister a window from the XSystem.

DestroyWindow is a blocking call for window destruction and can be called within any context. Depending on the implementation the IWindow::Destroy method to pWindow will be called. The implementation has to make sure the window destruction is done only within the main message queue thread. Otherwise it may fail.

Parameters
[in]oWindowWindow implementation. Consider adtf::ui::riddler::cQtWindow.
Returns
Usually this is the return value of the resulting IWindow::Destroy method.
Return values
ERR_NOT_FOUNDThe window is not registered.
See also
IWindow::Destroy, adtf::ui::ant::cQtWindow