Scribus
Open source desktop publishing at your fingertips
PictureBrowserPlugin Class Reference

See scplugin.h and pluginmanager.{cpp,h} for detail on what these methods do. That documentatation is not duplicated here. Please don't implement the functionality of your plugin here; do that in mypluginimpl.h and mypluginimpl.cpp. More...

#include <picturebrowserplugin.h>

Inheritance diagram for PictureBrowserPlugin:
Collaboration diagram for PictureBrowserPlugin:

Public Slots

void closePictureBrowser ()
 
- Public Slots inherited from ScActionPlugin
virtual bool run (QWidget *parent, ScribusDoc *doc, QString target=QString::null)
 Run the plug-in's main action. More...
 
virtual bool run (ScribusDoc *doc, QIODevice *target)
 Run the plugin on a QIODevice. More...
 
virtual DeferredTaskrunAsync (QString target=QString::null)
 Run the plugin asynchronously. More...
 
virtual DeferredTaskrunAsync (QIODevice *target)
 Run the plugin asynchronously. More...
 
const QString & runResult () const
 ! Obsolete method - do not use this or rely on it in new code.
 

Public Member Functions

 PictureBrowserPlugin ()
 Standard plugin implementation.
 
virtual bool cleanupPlugin ()
 Deactivates the plugin for unloading / program quit. More...
 
virtual bool run (ScribusDoc *doc, QString target=QString::null)
 main method to run the plug
 
virtual const QString fullTrName () const
 Plug-in's human-readable, translated name. More...
 
virtual const AboutDatagetAboutData () const
 Return descriptive information about the plug-in. More...
 
virtual void deleteAboutData (const AboutData *about) const
 
virtual void languageChange ()
 Update all user-visible text to reflect current UI language. More...
 
virtual void addToMainWindowMenu (ScribusMainWindow *)
 Allow plugins to add to a main menu.
 
virtual void setDoc (ScribusDoc *doc)
 hooks that plugins can use to detect if the current document was closed etc..
 
virtual void unsetDoc ()
 
virtual void changedDoc (ScribusDoc *doc)
 
- Public Member Functions inherited from ScActionPlugin
 ScActionPlugin ()
 ctor More...
 
virtual ~ScActionPlugin ()=0
 Pure virtual dtor - abstract class.
 
const ActionInfoactionInfo () const
 
virtual bool handleSelection (ScribusDoc *doc, int SelectedType=-1)
 handle the documents selection. More...
 
- Public Member Functions inherited from ScPlugin
 ScPlugin ()
 ctor, returns a new ScPlugin instance More...
 
virtual ~ScPlugin ()=0
 Destroy the ScPlugin instance. More...
 
virtual bool newPrefsPanelWidget (QWidget *parent, PrefsPanel *&panel, QString &caption, QPixmap &icon)
 Create and return a prefs UI panel for the plugin. More...
 
virtual bool newPrefsPanelWidget (QWidget *parent, Prefs_Pane *&panel, QString &caption, QPixmap &icon)
 
const QString & lastError () const
 Text summary of last error encountered. More...
 
bool hasLastError () const
 Returns if lastError message is not empty.
 
void clearLastError ()
 Clear last error message.
 
const QString pluginTypeName () const
 Returns human readable plugin type from plug-in's pluginType.
 

Additional Inherited Members

- Protected Attributes inherited from ScActionPlugin
ActionInfo m_actionInfo
 
QString m_runResult
 
ScribusDocm_Doc
 
- Protected Attributes inherited from ScPlugin
QString m_lastError
 Human readable, translated version of last error to occur.
 

Detailed Description

See scplugin.h and pluginmanager.{cpp,h} for detail on what these methods do. That documentatation is not duplicated here. Please don't implement the functionality of your plugin here; do that in mypluginimpl.h and mypluginimpl.cpp.

Member Function Documentation

bool PictureBrowserPlugin::cleanupPlugin ( )
virtual

Deactivates the plugin for unloading / program quit.

This method will be called when the plug-in is about to be unloaded, or if the plug-in manager has been asked to disable the plug-in. This method will never be called unless initPlugin has been called first, but there is no guarantee the plugin will actually be unloaded after this is called, or before initPlugin is called again.

Returns
bool True for success.

Reimplemented from ScActionPlugin.

const QString PictureBrowserPlugin::fullTrName ( ) const
virtual

Plug-in's human-readable, translated name.

Please don't use this for anything except display to the user. The results of testing the value of this can not be guaranteed, as its value may change depending on locale and change at runtime.

Implements ScPlugin.

const ScActionPlugin::AboutData * PictureBrowserPlugin::getAboutData ( ) const
virtual

Return descriptive information about the plug-in.

Returns a structure containing descriptive information about the plug-in. This information is used in places like the Help->About Plug-ins menu item. The stucture MUST be deleted using deleteAboutData(AboutData* about) when finished with.

Every plugin MUST reimplement getAboutData(...) and deleteAboutData(...).

See also
ScPlugin::deleteAboutData

Implements ScPlugin.

void PictureBrowserPlugin::languageChange ( )
virtual

Update all user-visible text to reflect current UI language.

Updates the text on all widgets on the plug-in to reflect the new language. You should generally use this method to set all the widget text during construction. That ensures that text is not duplicated, and that when this method is called the text of all persistent widgets is correctly changed.

This method only needs to affect text in widgets that currently exists (displayed or otherwise).

Implements ScPlugin.


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