File indexing completed on 2024-04-28 04:44:15

 /*
     SnoreNotify is a Notification Framework based on Qt
     Copyright (C) 2015  Hannah von Reth <vonreth@kde.org>
 
     SnoreNotify is free software: you can redistribute it and/or modify
     it under the terms of the GNU Lesser General Public License as published by
     the Free Software Foundation, either version 3 of the License, or
     (at your option) any later version.
 
     SnoreNotify is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU Lesser General Public License for more details.
 
     You should have received a copy of the GNU Lesser General Public License
     along with SnoreNotify.  If not, see <http://www.gnu.org/licenses/>.
 */
 #ifndef UTILS_H
 #define UTILS_H
 
 #include "snore_exports.h"
 #include "snoreglobals.h"
 
 #include <QImage>
 #include <QObject>
 #include <QWindow>
 
 namespace Snore
 {
 class SNORE_EXPORT  Utils : public QObject
 {
     Q_OBJECT
 public:
     /**
      * The MarkupFlag enum.
      * If a flag is not present the markup key will be removed.
      * If any flag is present, special characters mus be html escaped.
      */
     enum MarkupFlag {
         /**
          * No markup is supported.
          * All markup will be removed.
          */
         NoMarkup   = 0,
 
         /**
          * Urls are supprotet.
          * &lt;a href="www.foo.bar"&gt;Foo Bar&lt;/a&gt;
          */
         Href        = 1 << 0,
 
         /**
          * Line breaks &lt;br&gt; are supprotet.
          * If the flag is not present &lt;br&gt; will be replaced by \\n
          */
         Break       = 1 << 1,
 
         /**
          * Bold &lt;b&gt; is supportet.
          */
         Bold        = 1 << 2,
 
         /**
          * Italic &lt;i&gt; is supportet.
          */
         Italic      = 1 << 3,
 
         /**
          * Underline &lt;u&gt; is supportet.
          */
         Underline   = 1 << 4,
 
         /**
          * Fonst are supportet.
          * &lt;font color="blue"&gt; word &lt;/font&gt;
          */
         Font        = 1 << 5,
 
         /**
          * All markup is supported.
          * No markup will be removed.
          */
         AllMarkup  = ~0
     };
 
     Q_DECLARE_FLAGS(MarkupFlags, MarkupFlag)
 
     Utils(QObject *parent = nullptr);
     ~Utils();
 
     /**
      * Raise a window to the front and activates it.
      * @param window the window to raise.
      * @param focus whether the window should request focus.
      */
     Q_INVOKABLE static void bringWindowToFront(const QWindow *window, bool focus);
 
 #ifdef Q_OS_WIN
     static void bringWindowToFront(HWND wid, bool focus);
 #endif
 
     /**
      * Raised the Window to front and don't make it active or steal focus.
      */
     Q_INVOKABLE static void raiseWindowToFront(const QWindow *window);
 
     /**
      * Removes unsupported markup tags from a string.
      */
     static QString normalizeMarkup(QString string, MarkupFlags tags);
 
     /**
      * Version number prefix for the settings.
      */
     static inline QString settingsVersionSchema()
     {
         return QStringLiteral("v1");
     }
 
     /**
      * Returns the SettingsKey formated with type and version.
      * @param key The key.
      * @param type The Type.
      * @param application The application's name.
      */
     static inline QString normalizeSettingsKey(const QString &key, SettingsType type, const QString &application)
     {
         if (type == LocalSetting) {
             return settingsVersionSchema() + QLatin1String("/LocalSettings/") + application + QLatin1Char('/') + key;
         } else {
             return settingsVersionSchema() + QLatin1String("/GlobalSettings/") +  key;
         }
     }
 
     static QByteArray dataFromImage(const QImage &image);
 
 private:
 #ifdef Q_OS_WIN
     static int attatchToActiveProcess();
     static void detatchActiveProcess(int idActive);
 #endif
 
 };
 
 }
 Q_DECLARE_OPERATORS_FOR_FLAGS(Snore::Utils::MarkupFlags)
 
 #endif // UTILS_H