/*************************************************************************** quantaplugin.cpp - Base class for quanta plugins ------------------- begin : Mon Sep 16 2002 copyright : (C) 2002 by Marc Britton (C) 2003-2004 by Andras Mantia ***************************************************************************/ /*************************************************************************** * * * 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 #include #include #include #include #include #include #include #include #include /* QT INCLUDES */ #include #include #include #include #include #include #include /* 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, TQT_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(partInfo.baseName().latin1(), m_targetWidget, 0, m_targetWidget, 0 ); else m_part = KParts::ComponentFactory::createPartInstanceFromLibrary(partInfo.baseName().latin1(), m_targetWidget, 0, m_targetWidget, 0 ); if(!m_part) { KMessageBox::error(quantaApp, i18n("The %1 plugin could not be loaded.
Possible reasons are:
- %2 is not installed;
- the file %3 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, TQT_SIGNAL(setStatusBarText(const TQString &)), quantaApp, TQT_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, TQT_SIGNAL(setStatusBarText(const TQString &)), quantaApp, TQT_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"