class IWidgetLayoutHandler
{
    // OPTIONAL: turns on/off the layout handler
    Q_PROPERTY(bool enable RW)
    // OPTIONAL: returns the enabled state of the layout handler
    Q_PROPERTY(bool isEnabled R)
public: // public invokable methods
public signals:
    // OPTIONAL: emited by the handler when the widget must update its content
    void updateWidget();
    // OPTIONAL: update widget
    void updateLayout(const QString &layoutFile);
public slots:
    // MANDATORY: the slot initializes the layout handler internals and connects to the owner
    void initializeLayout(const HbDocumentLoader &layoutLoader, QObject *owner);
    // MANDATORY: updates the layout content
    void updateLayout();
    //OPTIONAL: reacts on gestures
    void onTap(QPointF& point);
    // OPTIONAL: updates the layout upon theme change
    void onThemeChange();
};