KisKXMLGUIBuilder Class Reference

#include <kxmlguibuilder.h>

Inheritance diagram for KisKXMLGUIBuilder:

Public Member Functions
KisKXMLGUIClient *	builderClient () const
virtual QStringList	containerTags () const
virtual QWidget *	createContainer (QWidget *parent, int index, const QDomElement &element, QAction *&containerAction)
virtual QAction *	createCustomElement (QWidget *parent, int index, const QDomElement &element)
virtual QStringList	customTags () const
virtual void	finalizeGUI (KisKXMLGUIClient *client)
	KisKXMLGUIBuilder (QWidget *widget)
virtual void	removeContainer (QWidget *container, QWidget *parent, QDomElement &element, QAction *containerAction)
virtual void	removeCustomElement (QWidget *parent, QAction *action)
void	setBuilderClient (KisKXMLGUIClient *client)
QWidget *	widget ()
virtual	~KisKXMLGUIBuilder ()

Protected Member Functions
virtual void	virtual_hook (int id, void *data)

Private Attributes
KisKXMLGUIBuilderPrivate *const	d

Detailed Description

Implements the creation of the GUI (menubar, menus and toolbars) as requested by the GUI factory.

The virtual methods are mostly for historical reasons, there isn't really a need to derive from KisKXMLGUIBuilder anymore.

Definition at line 28 of file kxmlguibuilder.h.

Constructor & Destructor Documentation

KisKXMLGUIBuilder()

KisKXMLGUIBuilder::KisKXMLGUIBuilder ( QWidget * widget )

explicit

Definition at line 65 of file kxmlguibuilder.cpp.

    : d(new KisKXMLGUIBuilderPrivate)
{
    d->m_widget = widget;
 
    d->tagMainWindow = QStringLiteral("mainwindow");
    d->tagMenuBar = QStringLiteral("menubar");
    d->tagMenu = QStringLiteral("menu");
    d->tagToolBar = QStringLiteral("toolbar");
    d->tagStatusBar = QStringLiteral("statusbar");
 
    d->tagSeparator = QStringLiteral("separator");
    d->tagTearOffHandle = QStringLiteral("tearoffhandle");
    d->tagMenuTitle = QStringLiteral("title");
 
    d->attrName = QStringLiteral("name");
    d->attrLineSeparator = QStringLiteral("lineseparator");
 
    d->attrDomain = QStringLiteral("translationDomain");
    d->attrText1 = QStringLiteral("text");
    d->attrText2 = QStringLiteral("Text");
    d->attrContext = QStringLiteral("context");
 
    d->attrIcon = QStringLiteral("icon");
}

References KisKXMLGUIBuilderPrivate::attrContext, KisKXMLGUIBuilderPrivate::attrDomain, KisKXMLGUIBuilderPrivate::attrIcon, KisKXMLGUIBuilderPrivate::attrLineSeparator, KisKXMLGUIBuilderPrivate::attrName, KisKXMLGUIBuilderPrivate::attrText1, KisKXMLGUIBuilderPrivate::attrText2, d, KisKXMLGUIBuilderPrivate::m_widget, KisKXMLGUIBuilderPrivate::tagMainWindow, KisKXMLGUIBuilderPrivate::tagMenu, KisKXMLGUIBuilderPrivate::tagMenuBar, KisKXMLGUIBuilderPrivate::tagMenuTitle, KisKXMLGUIBuilderPrivate::tagSeparator, KisKXMLGUIBuilderPrivate::tagStatusBar, KisKXMLGUIBuilderPrivate::tagTearOffHandle, KisKXMLGUIBuilderPrivate::tagToolBar, and widget().

~KisKXMLGUIBuilder()

KisKXMLGUIBuilder::~KisKXMLGUIBuilder ( )

virtual

Definition at line 91 of file kxmlguibuilder.cpp.

{
    delete d;
}

References d.

Member Function Documentation

builderClient()

KisKXMLGUIClient * KisKXMLGUIBuilder::builderClient

(

)

const

Definition at line 374 of file kxmlguibuilder.cpp.

{
    return d->m_client;
}

References d, and KisKXMLGUIBuilderPrivate::m_client.

containerTags()

QStringList KisKXMLGUIBuilder::containerTags ( ) const

virtual

Definition at line 101 of file kxmlguibuilder.cpp.

{
    QStringList res;
    res << d->tagMenu << d->tagToolBar << d->tagMainWindow << d->tagMenuBar << d->tagStatusBar;
 
    return res;
}

References d, KisKXMLGUIBuilderPrivate::tagMainWindow, KisKXMLGUIBuilderPrivate::tagMenu, KisKXMLGUIBuilderPrivate::tagMenuBar, KisKXMLGUIBuilderPrivate::tagStatusBar, and KisKXMLGUIBuilderPrivate::tagToolBar.

createContainer()

QWidget * KisKXMLGUIBuilder::createContainer ( QWidget * parent, int index, const QDomElement & element, QAction *& containerAction )

virtual

Creates a container (menubar/menu/toolbar/statusbar/separator/...) from an element in the XML file

Parameters

parent	The parent for the container
index	The index where the container should be inserted into the parent container/widget
element	The element from the DOM tree describing the container (use it to access container specified attributes or child elements)
containerAction	The action created for this container; used for e.g. passing to removeContainer.

Definition at line 109 of file kxmlguibuilder.cpp.

{
    containerAction = 0;
 
    if (element.attribute(QStringLiteral("deleted")).toLower() == QLatin1String("true")) {
        return 0;
    }
 
    const QString tagName = element.tagName().toLower();
    if (tagName == d->tagMainWindow) {
        KisKMainWindow *mainwindow = qobject_cast<KisKMainWindow *>(d->m_widget);  // could be 0
        return mainwindow;
    }
 
    if (tagName == d->tagMenuBar) {
        KisKMainWindow *mainWin = qobject_cast<KisKMainWindow *>(d->m_widget);
        QMenuBar *bar = 0;
        if (mainWin) {
            bar = mainWin->menuBar();
        }
        if (!bar) {
            bar = new QMenuBar(d->m_widget);
        }
        bar->show();
        return bar;
    }
 
    if (tagName == d->tagMenu) {
        // Look up to see if we are inside a mainwindow. If yes, then
        // use it as parent widget (to get kaction to plug itself into the
        // mainwindow). Don't use a popupmenu as parent widget, otherwise
        // the popup won't be hidden if it is used as a standalone menu as well.
        //
        // Note: menus with a parent of 0, coming from child clients, can be
        // leaked if the child client is deleted without a proper removeClient call, though.
 
        QWidget *p = parent;
 
        if (!p && qobject_cast<QMainWindow *>(d->m_widget)) {
                    p = d->m_widget;
        }
 
        while (p && !qobject_cast<QMainWindow *>(p)) {
            p = p->parentWidget();
        }
 
        QString name = element.attribute(d->attrName);
 
        QMenu *popup = new QMenu(p);
        popup->setObjectName(name);
 
        QString i18nText;
        QDomElement textElem = element.namedItem(d->attrText1).toElement();
        if (textElem.isNull()) { // try with capital T
            textElem = element.namedItem(d->attrText2).toElement();
        }
        const QString text = textElem.text();
        const QString context = textElem.attribute(d->attrContext);
 
        //qDebug(260) << "DOMAIN" << KLocalizedString::applicationDomain();
        //qDebug(260) << "ELEMENT TEXT:" << text;
 
        if (text.isEmpty()) { // still no luck
            i18nText = i18n("No text");
        } else {
            QByteArray domain = textElem.attribute(d->attrDomain).toUtf8();
            if (domain.isEmpty()) {
                domain = element.ownerDocument().documentElement().attribute(d->attrDomain).toUtf8();
                if (domain.isEmpty()) {
                    domain = KLocalizedString::applicationDomain();
                }
            }
            if (context.isEmpty()) {
                i18nText = i18nd(domain.constData(), text.toUtf8().constData());
            } else {
                i18nText = i18ndc(domain.constData(), context.toUtf8().constData(), text.toUtf8().constData());
            }
        }
 
        //qDebug(260) << "ELEMENT i18n TEXT:" << i18nText;
 
        const QString icon = element.attribute(d->attrIcon);
        QIcon pix;
        if (!icon.isEmpty()) {
            pix = KisIconUtils::loadIcon(icon);
        }
 
        if (parent) {
            QAction *act = popup->menuAction();
            if (!icon.isEmpty()) {
                act->setIcon(pix);
            }
            act->setText(i18nText);
            if (index == -1 || index >= parent->actions().count()) {
                parent->addAction(act);
            } else {
                parent->insertAction(parent->actions().value(index), act);
            }
            containerAction = act;
            containerAction->setObjectName(name);
        }
 
        return popup;
    }
 
    if (tagName == d->tagToolBar) {
        QString name = element.attribute(d->attrName);
 
        KisToolBar *bar = static_cast<KisToolBar *>(d->m_widget->findChild<KisToolBar *>(name));
        if (!bar) {
            bar = new KisToolBar(name, d->m_widget, false);
        }
 
        if (qobject_cast<KisKMainWindow *>(d->m_widget)) {
            if (d->m_client && !d->m_client->xmlFile().isEmpty()) {
                bar->addXMLGUIClient(d->m_client);
            }
        }
 
        bar->loadState(element);
 
        return bar;
    }
 
    if (tagName == d->tagStatusBar) {
        KisKMainWindow *mainWin = qobject_cast<KisKMainWindow *>(d->m_widget);
        if (mainWin) {
            mainWin->statusBar()->show();
            return mainWin->statusBar();
        }
        QStatusBar *bar = new QStatusBar(d->m_widget);
        return bar;
    }
 
    return 0L;
}

References KisToolBar::addXMLGUIClient(), KisKXMLGUIBuilderPrivate::attrContext, KisKXMLGUIBuilderPrivate::attrDomain, KisKXMLGUIBuilderPrivate::attrIcon, KisKXMLGUIBuilderPrivate::attrName, KisKXMLGUIBuilderPrivate::attrText1, KisKXMLGUIBuilderPrivate::attrText2, d, KisIconUtils::loadIcon(), KisToolBar::loadState(), KisKXMLGUIBuilderPrivate::m_client, KisKXMLGUIBuilderPrivate::m_widget, p, KisKXMLGUIBuilderPrivate::tagMainWindow, KisKXMLGUIBuilderPrivate::tagMenu, KisKXMLGUIBuilderPrivate::tagMenuBar, KisKXMLGUIBuilderPrivate::tagStatusBar, KisKXMLGUIBuilderPrivate::tagToolBar, and KisKXMLGUIClient::xmlFile().

createCustomElement()

QAction * KisKXMLGUIBuilder::createCustomElement ( QWidget * parent, int index, const QDomElement & element )

virtual

Definition at line 286 of file kxmlguibuilder.cpp.

{
    QAction *before = 0L;
    if (index > 0 && index < parent->actions().count()) {
        before = parent->actions().at(index);
    }
 
    const QString tagName = element.tagName().toLower();
    if (tagName == d->tagSeparator) {
        if (QMenu *menu = qobject_cast<QMenu *>(parent)) {
            // QMenu already cares for leading/trailing/repeated separators
            // no need to check anything
            return menu->insertSeparator(before);
        } else if (QMenuBar *bar = qobject_cast<QMenuBar *>(parent)) {
            QAction *separatorAction = new QAction(bar);
            separatorAction->setSeparator(true);
            bar->insertAction(before, separatorAction);
            return separatorAction;
        } else if (KisToolBar *bar = qobject_cast<KisToolBar *>(parent)) {
            /* FIXME KAction port - any need to provide a replacement for lineSeparator/normal separator?
            bool isLineSep = true;
 
            QDomNamedNodeMap attributes = element.attributes();
            unsigned int i = 0;
            for (; i < attributes.length(); i++ )
            {
              QDomAttr attr = attributes.item( i ).toAttr();
 
              if ( attr.name().toLower() == d->attrLineSeparator &&
                   attr.value().toLower() == QStringLiteral("false") )
              {
                isLineSep = false;
                break;
              }
            }
 
            if ( isLineSep )
                return bar->insertSeparator( index ? bar->actions()[index - 1] : 0L );
            else*/
 
            return bar->insertSeparator(before);
        }
    } else if (tagName == d->tagTearOffHandle) {
        static_cast<QMenu *>(parent)->setTearOffEnabled(true);
    } else if (tagName == d->tagMenuTitle) {
        if (QMenu *m = qobject_cast<QMenu *>(parent)) {
            QString i18nText;
            const QString text = element.text();
 
            if (text.isEmpty()) {
                i18nText = i18n("No text");
            } else {
                QByteArray domain = element.attribute(d->attrDomain).toUtf8();
                if (domain.isEmpty()) {
                    domain = element.ownerDocument().documentElement().attribute(d->attrDomain).toUtf8();
                    if (domain.isEmpty()) {
                        domain = KLocalizedString::applicationDomain();
                    }
                }
                i18nText = i18nd(domain.constData(), qPrintable(text));
            }
 
            QString icon = element.attribute(d->attrIcon);
            QIcon pix;
 
            if (!icon.isEmpty()) {
                pix = KisIconUtils::loadIcon(icon);
            }
 
            if (!icon.isEmpty()) {
                return m->insertSection(before, pix, i18nText);
            } else {
                return m->insertSection(before, i18nText);
            }
        }
    }
 
    QAction *blank = new QAction(parent);
    blank->setVisible(false);
    parent->insertAction(before, blank);
    return blank;
}

References KisKXMLGUIBuilderPrivate::attrDomain, KisKXMLGUIBuilderPrivate::attrIcon, d, KisIconUtils::loadIcon(), KisKXMLGUIBuilderPrivate::tagMenuTitle, KisKXMLGUIBuilderPrivate::tagSeparator, and KisKXMLGUIBuilderPrivate::tagTearOffHandle.

customTags()

QStringList KisKXMLGUIBuilder::customTags ( ) const

virtual

Definition at line 279 of file kxmlguibuilder.cpp.

{
    QStringList res;
    res << d->tagSeparator << d->tagTearOffHandle << d->tagMenuTitle;
    return res;
}

References d, KisKXMLGUIBuilderPrivate::tagMenuTitle, KisKXMLGUIBuilderPrivate::tagSeparator, and KisKXMLGUIBuilderPrivate::tagTearOffHandle.

finalizeGUI()

void KisKXMLGUIBuilder::finalizeGUI ( KisKXMLGUIClient * client )

virtual

Reimplemented in KXmlGuiWindow.

Definition at line 384 of file kxmlguibuilder.cpp.

{
    KXmlGuiWindow *window = qobject_cast<KXmlGuiWindow *>(d->m_widget);
    if (!window) {
        return;
    }
#if 0
    KisToolBar *toolbar = 0;
    QListIterator<KisToolBar> it(((KisKMainWindow *)d->m_widget)->toolBarIterator());
    while ((toolbar = it.current())) {
        //qDebug(260) << "KisKXMLGUIBuilder::finalizeGUI toolbar=" << (void*)toolbar;
        ++it;
        toolbar->positionYourself();
    }
#else
    window->finalizeGUI(false);
#endif
}

References d, KXmlGuiWindow::finalizeGUI(), and KisKXMLGUIBuilderPrivate::m_widget.

removeContainer()

void KisKXMLGUIBuilder::removeContainer ( QWidget * container, QWidget * parent, QDomElement & element, QAction * containerAction )

virtual

Removes the given (and previously via createContainer ) created container.

Definition at line 246 of file kxmlguibuilder.cpp.

{
    // Warning parent can be 0L
 
    if (qobject_cast<QMenu *>(container)) {
        if (parent) {
            parent->removeAction(containerAction);
        }
 
        delete container;
    } else if (qobject_cast<KisToolBar *>(container)) {
        KisToolBar *tb = static_cast<KisToolBar *>(container);
 
        tb->saveState(element);
        delete tb;
    } else if (qobject_cast<QMenuBar *>(container)) {
        QMenuBar *mb = static_cast<QMenuBar *>(container);
        mb->hide();
        // Don't delete menubar - it can be reused by createContainer.
        // If you decide that you do need to delete the menubar, make
        // sure that QMainWindow::d->mb does not point to a deleted
        // menubar object.
    } else if (qobject_cast<QStatusBar *>(container)) {
        if (qobject_cast<KisKMainWindow *>(d->m_widget)) {
            container->hide();
        } else {
            delete static_cast<QStatusBar *>(container);
        }
    } else {
        qWarning() << "Unhandled container to remove : " << container->metaObject()->className();
    }
}

References d, KisKXMLGUIBuilderPrivate::m_widget, and KisToolBar::saveState().

removeCustomElement()

void KisKXMLGUIBuilder::removeCustomElement ( QWidget * parent, QAction * action )

virtual

Definition at line 369 of file kxmlguibuilder.cpp.

{
    parent->removeAction(action);
}

setBuilderClient()

void KisKXMLGUIBuilder::setBuilderClient

(

KisKXMLGUIClient *

client

)

Definition at line 379 of file kxmlguibuilder.cpp.

{
    d->m_client = client;
}

References d, and KisKXMLGUIBuilderPrivate::m_client.

virtual_hook()

void KisKXMLGUIBuilder::virtual_hook ( int id, void * data )

protectedvirtual

Definition at line 403 of file kxmlguibuilder.cpp.

{
    /*BASE::virtual_hook( id, data );*/
}

widget()

QWidget * KisKXMLGUIBuilder::widget

(

)

Definition at line 96 of file kxmlguibuilder.cpp.

{
    return d->m_widget;
}

References d, and KisKXMLGUIBuilderPrivate::m_widget.

Member Data Documentation

d

KisKXMLGUIBuilderPrivate* const KisKXMLGUIBuilder::d

private

Definition at line 78 of file kxmlguibuilder.h.

---

The documentation for this class was generated from the following files:

• libs/widgetutils/xmlgui/kxmlguibuilder.h
• libs/widgetutils/xmlgui/kxmlguibuilder.cpp