File indexing completed on 2024-04-14 03:48:04

 // SPDX-License-Identifier: LGPL-2.1-or-later
 //
 // SPDX-FileCopyrightText: 2010 Dennis Nienhüser <nienhueser@kde.org>
 // SPDX-FileCopyrightText: 2011 Thibaut Gridel <tgridel@free.fr>
 
 #ifndef MARBLE_SEARCHRUNNERPLUGIN_H
 #define MARBLE_SEARCHRUNNERPLUGIN_H
 
 #include <QObject>
 #include "PluginInterface.h"
 
 namespace Marble
 {
 
 class SearchRunner;
 
 /**
   * A plugin for Marble to execute a placemark search.
   */
 class MARBLE_EXPORT SearchRunnerPlugin : public QObject, public PluginInterface
 {
     Q_OBJECT
 
 public:
     /** Constructor with optional parent object */
     explicit SearchRunnerPlugin( QObject* parent = nullptr );
 
     /** Destructor */
     ~SearchRunnerPlugin() override;
 
     /**
      * @brief Returns the string that should appear in the user interface.
      *
      * For example, "Nominatim" should be returned for the Nominatim search plugin.
      */
     virtual QString guiString() const = 0;
 
     /** Plugin factory method to create a new runner instance.
       * Method caller gets ownership of the returned object
       */
     virtual SearchRunner *newRunner() const = 0;
 
     /** True if the plugin supports its tasks on the given planet */
     bool supportsCelestialBody( const QString &celestialBodyId ) const;
 
     /** True if the plugin can execute its tasks without network access */
     bool canWorkOffline() const;
 
     /**
      * @brief Returns @code true @endcode if the plugin is able to perform its claimed task.
      *
      * The default implementation returns @code true @endcode. This method can be
      * overridden for example to indicate an incomplete installation.
      */
     virtual bool canWork() const;
 
     // Overridden methods with default implementations
 
     QIcon icon() const override;
 
 protected:
     void setSupportedCelestialBodies( const QStringList &celestialBodies );
 
     void setCanWorkOffline( bool canWorkOffline );
 
 private:
     class Private;
     Private *const d;
 };
 
 }
 
 Q_DECLARE_INTERFACE( Marble::SearchRunnerPlugin, "org.kde.Marble.SearchRunnerPlugin/1.01" )
 
 #endif // MARBLE_SEARCHRUNNERPLUGIN_H