You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
396 lines
9.7 KiB
396 lines
9.7 KiB
/***************************************************************************
|
|
quantaplugin.cpp - Base class for quanta plugins
|
|
-------------------
|
|
begin : Mon Sep 16 2002
|
|
copyright : (C) 2002 by Marc Britton <consume@optushome.com.au>
|
|
(C) 2003-2004 by Andras Mantia <amantia@kde.org>
|
|
***************************************************************************/
|
|
|
|
/***************************************************************************
|
|
* *
|
|
* This program is free software; you can redistribute it and/or modify *
|
|
* it under the terms of the GNU General Public License as published by *
|
|
* the Free Software Foundation; either version 2 of the License, or *
|
|
* (at your option) any later version. *
|
|
* *
|
|
***************************************************************************/
|
|
|
|
/* KDE INCLUDES */
|
|
#include <kstandarddirs.h>
|
|
#include <tdelocale.h>
|
|
#include <kiconloader.h>
|
|
#include <tdeaction.h>
|
|
#include <tdeparts/componentfactory.h>
|
|
#include <tdeparts/part.h>
|
|
#include <tdelocale.h>
|
|
#include <kdockwidget.h>
|
|
#include <kdebug.h>
|
|
#include <tdemessagebox.h>
|
|
|
|
/* QT INCLUDES */
|
|
#include <tqstring.h>
|
|
#include <tqfile.h>
|
|
#include <tqfileinfo.h>
|
|
#include <tqwidget.h>
|
|
#include <tqwidgetstack.h>
|
|
#include <tqstringlist.h>
|
|
#include <tqobject.h>
|
|
|
|
/* OTHER INCLUDES */
|
|
#include "quantaplugin.h"
|
|
#include "resource.h"
|
|
#include "quanta.h"
|
|
#include "quantaview.h"
|
|
#include "document.h"
|
|
#include "quantacommon.h"
|
|
#include "resource.h"
|
|
#include "messageoutput.h"
|
|
#include "project.h"
|
|
|
|
#include "viewmanager.h"
|
|
|
|
|
|
QuantaPlugin::QuantaPlugin()
|
|
: m_isRunning(false)
|
|
{
|
|
m_readOnlyPart = true;
|
|
m_action = 0L;
|
|
m_icon = "";
|
|
m_part = 0L;
|
|
m_view = 0L;
|
|
m_pluginToolView = 0L;
|
|
m_targetWidget = 0L;
|
|
}
|
|
|
|
QuantaPlugin::~QuantaPlugin()
|
|
{
|
|
unload();
|
|
}
|
|
|
|
/** Sets the superficial name of the plugin */
|
|
void QuantaPlugin::setPluginName(const TQString &a_name)
|
|
{
|
|
m_name = a_name;
|
|
if (!m_action)
|
|
{
|
|
m_action = new TDEToggleAction(i18n(a_name.utf8()), 0, this, TQ_SLOT(toggle()), quantaApp->actionCollection(), a_name.ascii());
|
|
}
|
|
m_action->setText(a_name);
|
|
}
|
|
|
|
TQString QuantaPlugin::pluginName() const
|
|
{
|
|
return m_name;
|
|
}
|
|
|
|
void QuantaPlugin::setLocation(const TQString &a_location)
|
|
{
|
|
m_location = a_location;
|
|
}
|
|
|
|
TQString QuantaPlugin::location() const
|
|
{
|
|
return m_location;
|
|
}
|
|
|
|
bool QuantaPlugin::load()
|
|
{
|
|
if(isLoaded())
|
|
return false;
|
|
|
|
TQString loc = location();
|
|
if(loc.isEmpty())
|
|
{
|
|
TDEStandardDirs *dirs = QuantaCommon::pluginDirs("lib");
|
|
loc = dirs->findResource("lib", fileName());
|
|
delete dirs;
|
|
}
|
|
else
|
|
{
|
|
loc += TQString("/") + fileName();
|
|
}
|
|
|
|
TQFileInfo partInfo(loc);
|
|
TQString ow = outputWindow();
|
|
m_targetWidget = new TQWidget(quantaApp);
|
|
if (m_readOnlyPart)
|
|
m_part = KParts::ComponentFactory::createPartInstanceFromLibrary<KParts::ReadOnlyPart>(partInfo.baseName().latin1(), m_targetWidget, 0, m_targetWidget, 0 );
|
|
else
|
|
m_part = KParts::ComponentFactory::createPartInstanceFromLibrary<KParts::ReadWritePart>(partInfo.baseName().latin1(), m_targetWidget, 0, m_targetWidget, 0 );
|
|
if(!m_part)
|
|
{
|
|
KMessageBox::error(quantaApp, i18n("<qt>The <b>%1</b> plugin could not be loaded.<br>Possible reasons are:<br> - <b>%2</b> is not installed;<br> - the file <i>%3</i> is not installed or it is not reachable.").arg(m_name).arg(m_name).arg(m_fileName));
|
|
delete m_targetWidget;
|
|
m_targetWidget = 0L;
|
|
return false;
|
|
}
|
|
m_part->setName(m_name.ascii()); // for better debug output
|
|
m_part->widget()->setName(m_name.ascii()); //needed to be able to dock the same plugin twice in separate toolviews
|
|
m_part->widget()->setFocusPolicy(TQWidget::ClickFocus);
|
|
quantaApp->slotNewPart(m_part, false); // register the part in the partmanager
|
|
return true;
|
|
}
|
|
|
|
bool QuantaPlugin::run()
|
|
{
|
|
if(!isLoaded())
|
|
load();
|
|
|
|
if(isLoaded())
|
|
{
|
|
bool result = true;
|
|
QuantaView *view = ViewManager::ref()->activeView();
|
|
if (view->document())
|
|
{
|
|
switch (m_input)
|
|
{
|
|
case 1: { result = m_part->openURL(view->document()->url());
|
|
break;
|
|
}
|
|
case 2: { KURL url = view->document()->url();
|
|
url.setPath(url.directory());
|
|
url.adjustPath(1);
|
|
result = m_part->openURL(url);
|
|
break;
|
|
}
|
|
case 3: { KURL url;
|
|
if ( Project::ref()->hasProject() &&
|
|
(Project::ref()->contains(view->document()->url()) ||
|
|
view->document()->isUntitled())
|
|
)
|
|
{
|
|
url = Project::ref()->projectBaseURL();
|
|
}
|
|
else
|
|
{
|
|
url = view->document()->url();
|
|
url.setPath(url.directory());
|
|
url.adjustPath(1);
|
|
}
|
|
result = m_part->openURL(url);
|
|
break;
|
|
}
|
|
default: ;
|
|
}
|
|
} else
|
|
{
|
|
if (m_input == 3 && (Project::ref()->hasProject())) //open project dir
|
|
result = m_part->openURL(Project::ref()->projectBaseURL());
|
|
}
|
|
if (!result)
|
|
{
|
|
unload(false);
|
|
return false;
|
|
}
|
|
addWidget();
|
|
setRunning(true);
|
|
connect( m_part, TQ_SIGNAL(setStatusBarText(const TQString &)),
|
|
quantaApp, TQ_SLOT(slotStatusMsg( const TQString & )));
|
|
|
|
|
|
emit pluginStarted();
|
|
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
bool QuantaPlugin::toggle()
|
|
{
|
|
if (isLoaded())
|
|
{
|
|
return unload();
|
|
} else
|
|
{
|
|
bool result = run();
|
|
if (!result)
|
|
{
|
|
m_action->blockSignals(true);
|
|
m_action->setChecked(false);
|
|
m_action->blockSignals(false);
|
|
}
|
|
return result;
|
|
}
|
|
}
|
|
|
|
/** Returns the file name of the plugin */
|
|
TQString QuantaPlugin::fileName() const
|
|
{
|
|
return m_fileName;
|
|
}
|
|
|
|
/** Sets the file name of the plugin */
|
|
void QuantaPlugin::setFileName(const TQString &a_fileName)
|
|
{
|
|
m_fileName = a_fileName;
|
|
}
|
|
|
|
/** Sets the output window */
|
|
void QuantaPlugin::setOutputWindow(const TQString &a_outputWindow)
|
|
{
|
|
m_outputWindow = a_outputWindow;
|
|
}
|
|
|
|
/** Gets the output window */
|
|
TQString QuantaPlugin::outputWindow() const
|
|
{
|
|
return m_outputWindow;
|
|
}
|
|
|
|
bool QuantaPlugin::validatePlugin(QuantaPlugin *a_plugin)
|
|
{
|
|
if(a_plugin)
|
|
{
|
|
return QuantaPlugin::validatePluginInfo(a_plugin->pluginName(),
|
|
a_plugin->location(), a_plugin->fileName(),
|
|
a_plugin->outputWindow());
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/** Returns true if the information of a plugin is valid, otherwise false */
|
|
bool QuantaPlugin::validatePluginInfo(const TQString & /*a_name*/,
|
|
const TQString &a_location, const TQString &a_fileName, const TQString &/*a_outputWindow*/)
|
|
{
|
|
bool valid = true;
|
|
// look the file up if location is null
|
|
if(!a_location.isEmpty())
|
|
{
|
|
TQString path = a_location + TQString("/") + a_fileName;
|
|
|
|
TQFileInfo pluginFile(path);
|
|
if(!pluginFile.exists())
|
|
valid = false;
|
|
/* TODO : What other tests should we perform? Permissions etc? */
|
|
}
|
|
else
|
|
{
|
|
if (valid)
|
|
{
|
|
TDEStandardDirs *dirs = QuantaCommon::pluginDirs("lib");
|
|
if(dirs->findResource("lib", a_fileName).isNull())
|
|
valid = false;
|
|
delete dirs;
|
|
}
|
|
}
|
|
return valid; // past all tests, valid
|
|
}
|
|
|
|
/** Returns whether the plugin is loaded or not */
|
|
bool QuantaPlugin::isLoaded()
|
|
{
|
|
return m_targetWidget != 0L;
|
|
}
|
|
|
|
bool QuantaPlugin::unload(bool remove)
|
|
{
|
|
if(!isLoaded())
|
|
return false;
|
|
|
|
disconnect( m_part, TQ_SIGNAL(setStatusBarText(const TQString &)),
|
|
quantaApp, TQ_SLOT(slotStatusMsg( const TQString & )));
|
|
|
|
delete (KParts::ReadOnlyPart*) m_part;
|
|
m_part = 0;
|
|
delete m_targetWidget;
|
|
m_targetWidget = 0L;
|
|
setRunning(false);
|
|
|
|
emit pluginStopped();
|
|
|
|
m_action->setChecked(false);
|
|
if (remove)
|
|
removeWidget();
|
|
return true;
|
|
}
|
|
|
|
bool QuantaPlugin::isRunning() const
|
|
{
|
|
return m_isRunning;
|
|
}
|
|
|
|
void QuantaPlugin::setRunning(bool a_enable)
|
|
{
|
|
m_isRunning = a_enable;
|
|
}
|
|
|
|
/** Sets the plugin's standard attribute */
|
|
void QuantaPlugin::setStandard(bool isStandard)
|
|
{
|
|
m_standard = isStandard;
|
|
}
|
|
|
|
/** Gets the plugin's standard attribute */
|
|
bool QuantaPlugin::isStandard() const
|
|
{
|
|
return m_standard;
|
|
}
|
|
|
|
/** No descriptions */
|
|
TQString QuantaPlugin::standardName()
|
|
{
|
|
return m_standardName;
|
|
}
|
|
/** No descriptions */
|
|
void QuantaPlugin::setStandardName(const TQString& a_stdName)
|
|
{
|
|
m_standardName = a_stdName;
|
|
}
|
|
/** No descriptions */
|
|
TQString QuantaPlugin::icon()
|
|
{
|
|
return m_icon;
|
|
}
|
|
/** No descriptions */
|
|
void QuantaPlugin::setIcon(const TQString& a_icon)
|
|
{
|
|
m_icon = a_icon;
|
|
if (m_action) m_action->setIcon(a_icon);
|
|
}
|
|
|
|
void QuantaPlugin::addWidget()
|
|
{
|
|
TQString ow = outputWindow();
|
|
if(ow == i18n("Separate Toolview"))
|
|
{
|
|
m_part->widget()->setCaption(m_name);
|
|
m_part->widget()->setIcon(SmallIcon(m_icon));
|
|
m_pluginToolView = quantaApp->addToolWindow(m_part->widget(), quantaApp->prevDockPosition(m_part->widget(), KDockWidget::DockBottom), quantaApp->getMainDockWidget());
|
|
m_pluginToolView->show();
|
|
} else
|
|
{
|
|
m_view = ViewManager::ref()->createView();
|
|
m_view->addPlugin(this);
|
|
}
|
|
}
|
|
|
|
void QuantaPlugin::removeWidget()
|
|
{
|
|
TQString ow = outputWindow();
|
|
if(ow == i18n("Separate Toolview"))
|
|
{
|
|
delete m_pluginToolView;
|
|
m_pluginToolView = 0L;
|
|
ViewManager::ref()->activeView()->setFocus();
|
|
} else
|
|
{
|
|
ViewManager::ref()->removeView(m_view, true);
|
|
}
|
|
}
|
|
|
|
TQWidget *QuantaPlugin::widget()
|
|
{
|
|
if (isLoaded()) {
|
|
return m_part->widget();
|
|
} else {
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
void QuantaPlugin::plugAction(TQPopupMenu *menu)
|
|
{
|
|
m_action->plug(menu);
|
|
}
|
|
|
|
#include "quantaplugin.moc"
|