File indexing completed on 2024-05-12 05:10:17

0001 /***************************************************************************
0002     Copyright (C) 2003-2009 Robby Stephenson <robby@periapsis.org>
0003  ***************************************************************************/
0004 
0005 /***************************************************************************
0006  *                                                                         *
0007  *   This program is free software; you can redistribute it and/or         *
0008  *   modify it under the terms of the GNU General Public License as        *
0009  *   published by the Free Software Foundation; either version 2 of        *
0010  *   the License or (at your option) version 3 or any later version        *
0011  *   accepted by the membership of KDE e.V. (or its successor approved     *
0012  *   by the membership of KDE e.V.), which shall act as a proxy            *
0013  *   defined in Section 14 of version 3 of the license.                    *
0014  *                                                                         *
0015  *   This program is distributed in the hope that it will be useful,       *
0016  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
0017  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
0018  *   GNU General Public License for more details.                          *
0019  *                                                                         *
0020  *   You should have received a copy of the GNU General Public License     *
0021  *   along with this program.  If not, see <http://www.gnu.org/licenses/>. *
0022  *                                                                         *
0023  ***************************************************************************/
0024 
0025 #ifndef TELLICO_UTILS_H
0026 #define TELLICO_UTILS_H
0027 
0028 #include <Qt>
0029 
0030 class QString;
0031 class QStringList;
0032 class QPixmap;
0033 class QDialog;
0034 
0035 /**
0036  * This file contains utility functions.
0037  *
0038  * @author Robby Stephenson
0039  */
0040 namespace Tellico {
0041   /**
0042    * Returns a list of the subdirectories in @param dir
0043    * Symbolic links are ignored
0044    */
0045   QStringList findAllSubDirs(const QString& dir);
0046   /**
0047    * Does something similar to KDE4 KStandardDirs::findALlResources with wildcards
0048    */
0049   QStringList locateAllFiles(const QString& fileName);
0050   /**
0051    * Return something likely to be the installation directory
0052    */
0053   QString installationDir();
0054 
0055   QString saveLocation(const QString& dir);
0056 
0057   const QPixmap& pixmap(const QString& value);
0058 
0059   /**
0060    * Checks that the tellico-common.xsl file has been properly copied
0061    * to the user's directory.
0062    */
0063   bool checkCommonXSLFile();
0064 
0065   void activateDialog(QDialog* dialog);
0066 }
0067 
0068 #endif