Unity Scopes API
unity::scopes::qt::QScopeBase Class Referenceabstract

Base class for a scope implementation. More...

#include <unity/scopes/qt/QScopeBase.h>

Inheritance diagram for unity::scopes::qt::QScopeBase:

Public Member Functions

virtual void start (QString const &)
 
virtual void stop ()
 
virtual QPreviewQueryBase::UPtr preview (const QResult &, const QActionMetadata &)=0
 
virtual QSearchQueryBase::UPtr search (unity::scopes::CannedQuery const &q, unity::scopes::SearchMetadata const &)=0
 

Detailed Description

Base class for a scope implementation.

Scopes are accessed by the scopes run time as a shared library (one library per scope). Each scope must implement a class that derives from QScopeBase, for example:

class MyScope : public unity::scopes::qt::QScopeBase
{
public:
MyScope();
virtual ~MyScope();
virtual void start(QString const& scope_id); // Optional
virtual void stop(); // Optional
// ...
};

In addition, the library must provide two functions with "C" linkage:

  • a create function that must return a pointer to the derived instance
  • a destroy function that is passed the pointer returned by the create function

If the create function throws an exception, the destroy function will not be called. If the create function returns NULL, the destroy function will be called with NULL as its argument.

Rather than hard-coding the names of the functions, use the UNITY_SCOPE_CREATE_FUNCTION and UNITY_SCOPE_DESTROY_FUNCTION macros, for example:

// You must provide a function that creates your scope on the heap and
// pass this function to the QScopeBaseAPI constructor.
{
return new MyScope();
}
{
// You must return a dynamically allocated QScopeBaseAPI instance here.
// In turn, that instance calls your creation function to instantiate
// your scope in the correct Qt thread.
return new QScopeBaseAPI(create_my_scope);
}
// The runtime, once it has stopped your scope, calls the destroy function.
void
{
delete scope;
}

After the scopes run time has obtained a pointer to the class instance from the create function, it calls start(), which allows the scope to initialize itself.

Member Function Documentation

virtual QPreviewQueryBase::UPtr unity::scopes::qt::QScopeBase::preview ( const QResult ,
const QActionMetadata  
)
pure virtual

Called each time a new preview is requested

virtual QSearchQueryBase::UPtr unity::scopes::qt::QScopeBase::search ( unity::scopes::CannedQuery const &  q,
unity::scopes::SearchMetadata const &   
)
pure virtual

Called each time a new query is requested

void QScopeBase::start ( QString const &  start_string)
virtual

Called once at startup

void QScopeBase::stop ( )
virtual

Called at shutdown


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