katie/src/gui/kernel/qguiplatformplugin.cpp

/****************************************************************************
**
** Copyright (C) 2015 The Qt Company Ltd.
** Copyright (C) 2016-2020 Ivailo Monev
**
** This file is part of the QtGui module of the Katie Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
**
** GNU Lesser General Public License Usage
** This file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** As a special exception, The Qt Company gives you certain additional
** rights. These rights are described in The Qt Company LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU General Public License version 3.0 requirements will be
** met: http://www.gnu.org/copyleft/gpl.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/

#include "qguiplatformplugin.h"
#include "qdebug.h"
#include "qfile.h"
#include "qdir.h"
#include "qsettings.h"
#include "qfactoryloader_p.h"
#include "qstylefactory.h"
#include "qapplication.h"
#include "qplatformdefs.h"
#include "qicon.h"

QT_BEGIN_NAMESPACE


/*! \internal
    Return (an construct if necesseray) the Gui Platform plugin.

    If no plugin can be loaded, the default one is returned.
 */
QGuiPlatformPlugin *qt_guiPlatformPlugin()
{
    static QGuiPlatformPlugin *plugin;
    if (!plugin)
    {
#ifndef QT_NO_LIBRARY

        QString key = QString::fromLocal8Bit(qgetenv("QT_PLATFORM_PLUGIN"));
        if (key.isEmpty()) {
            key = QString::fromLocal8Bit(qgetenv("DESKTOP_SESSION"));
        }

        if (!key.isEmpty() && QApplication::desktopSettingsAware()) {
            QFactoryLoader loader(QGuiPlatformPluginInterface_iid, QLatin1String("/gui_platform"));
            plugin = qobject_cast<QGuiPlatformPlugin *>(loader.instance(key));
        }
#endif // QT_NO_LIBRARY

        if(!plugin) {
            static QGuiPlatformPlugin def;
            plugin = &def;
        }
    }
    return plugin;
}


/*!
    \class QGuiPlatformPlugin
    \brief The QGuiPlatformPlugin provides abstraction between several other
    classes and the platform defaults

    Applications that are built on top of Qt may provide a plugin so 3rd party
    Qt application running in the platform are integrated and behaviour is
    consistent across all applications. The plugin to be loaded can be
    specified with QT_PLATFORM_PLUGIN environment variable. If it is not set,
    DESKTOP_SESSION will be used as fallback on X11.

    \sa QIcon, QFileIconProvider, QStyle
 */

/*!
    The constructor can be used to install hooks in Qt
 */
QGuiPlatformPlugin::QGuiPlatformPlugin(QObject *parent)
    : QObject(parent)
{
}

QGuiPlatformPlugin::~QGuiPlatformPlugin()
{
}

/*!
    Retuns the plugin keys, reimplementations should return keys other than
    the default
*/
QStringList QGuiPlatformPlugin::keys() const
{
    return QStringList() << QLatin1String("default");
};

/*!
    Returns the style string key to be used by application
*/
QString QGuiPlatformPlugin::styleName()
{
    return QLatin1String("cleanlooks");
}

/*
    returns an additional palette (only work on X11)
*/
QPalette QGuiPlatformPlugin::palette()
{
    return QPalette();
}

/*!
    Returns the icon theme name for \p QIcon::fromTheme.
*/
QString QGuiPlatformPlugin::systemIconThemeName()
{
    return QString::fromLatin1("hicolor");
}

/*!
    Returns list of system icon theme search paths. The environment
    variable XDG_DATA_DIRS affects the behaviour of the result
*/
QStringList QGuiPlatformPlugin::iconThemeSearchPaths()
{
    QStringList paths;

    // Add home directory first in search path
    QDir homeDir(QDir::homePath() + QLatin1String("/.icons"));
    if (homeDir.exists())
        paths.append(homeDir.path());

    QString xdgDirString = QFile::decodeName(getenv("XDG_DATA_DIRS"));
    if (xdgDirString.isEmpty())
        xdgDirString = QLatin1String("/usr/local/share/:/usr/share/");

    QStringList xdgDirs = xdgDirString.split(QLatin1Char(':'));

    for (int i = 0 ; i < xdgDirs.size() ; ++i) {
        QDir dir(xdgDirs[i]);
        if (dir.exists())
            paths.append(dir.path() + QLatin1String("/icons"));
    }

    return paths;
}

/*!
    Returns system icon. If the icon returned is null (default) the
    result from \p QIcon::fromTheme will be used instead
*/
QIcon QGuiPlatformPlugin::systemIcon(const QString &)
{
    return QIcon();
}

/*!
    Returns file icon. If the icon returned is null (default) the
    result from \p QFileIconProvider will be used instead
*/
QIcon QGuiPlatformPlugin::fileSystemIcon(const QFileInfo &)
{
    return QIcon();
}

/*!
    Like QStyle::styleHint
*/
int QGuiPlatformPlugin::platformHint(PlatformHint hint)
{
    int ret = 0;
    switch(hint)
    {
        case PH_ToolButtonStyle:
            ret = Qt::ToolButtonIconOnly;
            break;
        case PH_ToolBarIconSize:
            //by default keep ret = 0 so QCommonStyle will use the style default
            break;
        default:
            break;
    }
    return ret;
}

void QGuiPlatformPlugin::fileDialogDelete(QFileDialog *)
{
}

bool QGuiPlatformPlugin::fileDialogSetVisible(QFileDialog *, bool)
{
    return false;
}

QDialog::DialogCode QGuiPlatformPlugin::fileDialogResultCode(QFileDialog *)
{
    return QDialog::Rejected;
}

void QGuiPlatformPlugin::fileDialogSetDirectory(QFileDialog *, const QString &)
{
}

QString QGuiPlatformPlugin::fileDialogDirectory(const QFileDialog *) const
{
    return QString();
}

void QGuiPlatformPlugin::fileDialogSelectFile(QFileDialog *, const QString &)
{
}

QStringList QGuiPlatformPlugin::fileDialogSelectedFiles(const QFileDialog *) const
{
    return QStringList();
}

void QGuiPlatformPlugin::fileDialogSetFilter(QFileDialog *)
{
}

void QGuiPlatformPlugin::fileDialogSetNameFilters(QFileDialog *, const QStringList &)
{
}

void QGuiPlatformPlugin::fileDialogSelectNameFilter(QFileDialog *, const QString &)
{
}

QString QGuiPlatformPlugin::fileDialogSelectedNameFilter(const QFileDialog *) const
{
    return QString();
}

void QGuiPlatformPlugin::colorDialogDelete(QColorDialog *)
{
}

bool QGuiPlatformPlugin::colorDialogSetVisible(QColorDialog *, bool)
{
    return false;
}

void QGuiPlatformPlugin::colorDialogSetCurrentColor(QColorDialog *, const QColor &)
{
}

QT_END_NAMESPACE

#include "moc_qguiplatformplugin.h"