ADTF  3.18.2
qt_ui_service< SERVICEBASECLASS, QTWINDOWBASECLASS >

Implementation template which implements a service that derives from. More...

Inheritance diagram for qt_ui_service< SERVICEBASECLASS, QTWINDOWBASECLASS >:
[legend]

Public Member Functions

 qt_ui_service ()
 default CTOR This will register the common property "title" to the services IConfiguration
 
 ~qt_ui_service () override=default
 DTOR.
 
tResult ServiceInit () override
 Override ServiceInit method of the service to create a window. More...
 
tResult ServiceShutdown () override
 Override ServiceShutdown method of the service to destroy a window. More...
 
QString GetStateIdentifier () const
 Get the State Identifier for the Window State callbacks "OnLoadState" and "OnSaveState". More...
 
QString GetHelpLink () const
 Returns a filesystem help link to the windows documentation page. More...
 
- Public Member Functions inherited from cQtWindow
QString GetStateIdentifier () const override
 Returns The user defined window state identifier. More...
 
void OnLoadState ([[maybe_unused]] const QString &strStateFolder) override
 Callback function to load the internal window state from the given folder strStateFolder. More...
 
void OnSaveState ([[maybe_unused]] const QString &strStateFolder) const override
 Callback function to save the internal window state to the given folder strStateFolder. More...
 
QString GetHelpLink () const override
 Returns a filesystem help link to the windows documentation page. More...
 
- Public Member Functions inherited from IQtXSystem::IWindowState
virtual void OnLoadState (const QString &strStateFolder)=0
 Callback function to load the internal window state from the given folder strStateFolder. More...
 
virtual void OnSaveState (const QString &strStateFolder) const =0
 Callback function to save the internal window state to the given folder strStateFolder. More...
 

Private Attributes

adtf::ucom::object_ptr< adtf::ui::spider::IQtXSystemm_pXSystem
 The XSystem reference.
 

Additional Inherited Members

- Protected Member Functions inherited from cQtWindow
void EnableWindowState ()
 Enables the Window state callbacks. More...
 
bool IsWindowStateEnabled () const
 
- Protected Member Functions inherited from cQtWindow
 cQtWindow ()=default
 default CTOR
 
virtual ~cQtWindow ()=default
 default DTOR
 
virtual QWidget * CreateView ()=0
 Callback you have to implement and return a newly QWidget which will be embed to the oParentWidget of the Create. More...
 
virtual void ReleaseView ()=0
 Callback you have to implement to cleanup while destroying of the parents window. More...
 
tResult Create (const char *strWindowID, QWidget &oParentWidget) override
 Callback which in called within the applications main th thread to create a window. More...
 
tResult Destroy (QWidget &) override
 Callback which in called within the applications main th thread to deliver a destroy message to the windows implementation. More...
 
tResult OnIdle () override
 Callback for actions within a idle thread. More...
 
tResult OnTimer () override
 Callback for actions within a steady timer. More...
 
- Protected Member Functions inherited from IQtXSystem::IWindowState
 ~IWindowState ()=default
 protected DTOR
 
- Protected Member Functions inherited from IQtXSystem::IHelp
 ~IHelp ()=default
 protected DTOR
 
- Protected Attributes inherited from cQtWindow
adtf::base::property_variable< adtf::util::cString > m_strTitle
 title property variable will be set while window creating
 

Detailed Description

template<typename SERVICEBASECLASS, typename QTWINDOWBASECLASS = spider::cQtWindow>
class adtf::ui::spider::qt_ui_service< SERVICEBASECLASS, QTWINDOWBASECLASS >

Implementation template which implements a service that derives from.

  • SERVICEBASECLASS type
  • QTWINDOWBASECLASS type

The SERVICEBASECLASS type must fulfill following concept requirements:

The QTWINDOWBASECLASS type must fulfill following concept requirements:

Template Parameters
SERVICEBASECLASSA cADTFService implementation The Init and Shutdown method will be override.
QTWINDOWBASECLASSA IQtXSystem::IWindow implementation implementation. By default the adtf::ui::spider::cQtWindow type is used.

Definition at line 211 of file qt_ui_service.h.

Member Function Documentation

◆ GetHelpLink()

QString GetHelpLink ( ) const
inlinevirtual

Returns a filesystem help link to the windows documentation page.

Return values
emptyThe link will be ignored.
not-emptyThe filesystem help link to the windows documentation page.
Returns
It will return the property entry set by adtf::streaming::hollow::set_help_link

Implements IQtXSystem::IHelp.

Definition at line 271 of file qt_ui_service.h.

References adtf::streaming::spider::get_help_link().

◆ GetStateIdentifier()

QString GetStateIdentifier ( ) const
inlinevirtual

Get the State Identifier for the Window State callbacks "OnLoadState" and "OnSaveState".

Returns
QString The unique identifier for the Window state call.
Remarks
qt_ui_service will return the set GetOID() (object identifier)
See also
adtf::ui::riddler::IQtXSystem::IWindowState

Implements IQtXSystem::IWindowState.

Definition at line 262 of file qt_ui_service.h.

◆ ServiceInit()

tResult ServiceInit ( )
inlineoverride

Override ServiceInit method of the service to create a window.

Returns
Standard Return Code. Returning an error will result in breaking intializing of system.
Remarks
Use EnableWindowState within the services CTOR to activate window state callbacks
See also
adtf::ui::riddler::IQtXSystem::IWindowState

Definition at line 232 of file qt_ui_service.h.

References _runtime, IRuntime::GetObject(), qt_ui_service< SERVICEBASECLASS, QTWINDOWBASECLASS >::m_pXSystem, and RETURN_IF_FAILED.

◆ ServiceShutdown()

tResult ServiceShutdown ( )
inlineoverride

Override ServiceShutdown method of the service to destroy a window.

Returns
Standard Return Code. Error code will only be logged. Breaking shutdown is not possible.

Definition at line 249 of file qt_ui_service.h.

References qt_ui_service< SERVICEBASECLASS, QTWINDOWBASECLASS >::m_pXSystem, and RETURN_IF_POINTER_NULL.