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.
tdewebdev/kommander/editor/functionsimpl.cpp

393 lines
14 KiB

/***************************************************************************
functionsimpl.cpp - Function browser implementation
-------------------
copyright : (C) 2004 Michal Rudolf <mrudolf@kdewebdev.org>
***************************************************************************/
/***************************************************************************
* *
* This program is free software; you can redistribute it and/or mody *
* 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. *
* *
***************************************************************************/
/* QT INCLUDES */
#include <tqcheckbox.h>
#include <tqlabel.h>
#include <tqmetaobject.h>
#include <tqstringlist.h>
#include <tqregexp.h>
/* KDE INCLUDES */
#include <kcombobox.h>
#include <kglobal.h>
#include <kiconloader.h>
#include <klistbox.h>
#include <klineedit.h>
#include <klocale.h>
#include <kpushbutton.h>
#include <ktextedit.h>
#include <ktextbrowser.h>
#include <kdebug.h>
/* OTHER INCLUDES */
#include "functionsimpl.h"
#include "kommanderwidget.h"
#include "invokeclass.h"
#include "widgetdatabase.h"
const int MaxFunctionArgs = 6;
FunctionsDialog::FunctionsDialog(TQWidget* a_parent, const TQDict<TQWidget>& a_widgetList, bool useInternalParser, char* a_name,
bool a_modal)
: FunctionsDialogBase(a_parent, a_name, a_modal), m_widgetList(a_widgetList), m_useInternalParser(useInternalParser)
{
clearButton->setPixmap(KGlobal::iconLoader()->loadIcon("locationbar_erase", KIcon::Toolbar));
copyButton->setPixmap(KGlobal::iconLoader()->loadIcon("1downarrow", KIcon::Toolbar));
groupComboBox->insertStringList(SpecialInformation::groups());
connect(groupComboBox, TQT_SIGNAL(activated(int)), TQT_SLOT(groupChanged(int)));
connect(widgetComboBox, TQT_SIGNAL(activated(int)), TQT_SLOT(groupChanged(int)));
connect(functionListBox, TQT_SIGNAL(highlighted(int)), TQT_SLOT(functionChanged(int)));
connect(copyButton, TQT_SIGNAL(clicked()), TQT_SLOT(copyText()));
connect(clearButton, TQT_SIGNAL(clicked()), insertedText, TQT_SLOT(clear()));
// build widget name list
for (TQDictIterator<TQWidget> It(m_widgetList); It.current(); ++It)
m_widgetNames.append(It.currentKey());
m_widgetNames.sort();
widgetComboBox->insertStringList(m_widgetNames);
for (int j = 0; j < WidgetDatabase::count(); j++)
{
TQString group = WidgetDatabase::group(j);
if (group == "Kommander" || group == "Custom")
m_widgetTypes << WidgetDatabase::className(j);
}
m_widgetTypes.sort();
//TODO: Insert either the generic widget types or parse for on the fly created widget
//names. The problem is that the rest of the code depends on the fact that the widget
//from the widgetComboBox exists
// widgetComboBox->insertStringList(m_widgetTypes);
m_acceptedSlots = InvokeClass::acceptedSlots();
m_DCOP = -1; // Select DCOP functions by default
m_Slots = -1;
for (int i=0; i<groupComboBox->count(); i++)
{
if (groupComboBox->text(i) == i18n("Slots"))
{
m_Slots = i;
break;
}
}
if (!useInternalParser)
{
groupComboBox->removeItem(m_Slots);
m_Slots = -1;
}
for (int i=0; i<groupComboBox->count(); i++)
{
if (groupComboBox->text(i) == "DCOP")
{
m_DCOP = i;
break;
}
}
groupComboBox->changeItem(i18n("Functions"), m_DCOP); //this is a quick way to rename this group in the UI
groupComboBox->setCurrentItem(m_DCOP);
groupChanged(groupComboBox->currentItem());
}
FunctionsDialog::~FunctionsDialog()
{
}
TQString FunctionsDialog::functionText() const
{
return insertedText->text();
}
TQString FunctionsDialog::currentFunctionText()
{
TQString prefix, function;
int index = groupComboBox->currentItem();
TQString s = (index != m_DCOP ) ? groupComboBox->text(index) : "DCOP";
if (m_useInternalParser)
{
function = SpecialInformation::parserGroupName(s);
if (!function.isEmpty())
function += "_";
}
else
{
prefix = "@";
function = s + ".";
}
if (groupComboBox->currentText() == "Kommander")
return TQString("%1%2%3").tqarg(prefix).tqarg(functionListBox->currentText()).tqarg(params());
else if (groupComboBox->currentItem() == m_DCOP || groupComboBox->currentItem() == m_Slots)
return TQString("%1%2.%3%4").tqarg(prefix).tqarg(widgetComboBox->currentText().section(' ', 0, 0))
.tqarg(functionListBox->currentText().left(functionListBox->currentText().find('('))).tqarg(params());
else
return TQString("%1%2%3%4").tqarg(prefix).tqarg(function)
.tqarg(functionListBox->currentText()).tqarg(params());
}
void FunctionsDialog::groupChanged(int index)
{
index = groupComboBox->currentItem();
functionListBox->clear();
m_slotList.clear();
if (index == m_Slots)
{
KommanderWidget* a_atw = dynamic_cast<KommanderWidget *>(m_widgetList[widgetComboBox->currentText()]);
TQStringList pFunctions = TQStringList::fromStrList(a_atw->object()->tqmetaObject()->slotNames(true));
for (uint i=0; i<pFunctions.count(); i++)
{
TQString slot = pFunctions[i];
TQString slotArgStr = slot.section(TQRegExp("\\(|\\)"), 1);
if (slotArgStr.isEmpty() || m_acceptedSlots.contains(slotArgStr))
{
TQString name = slot.remove("()");
if (!m_slotList.contains(name))
{
m_slotList[name] = slot;
functionListBox->insertItem(name);
}
}
}
} else
{
TQString s = (index != m_DCOP ) ? groupComboBox->text(index) : "DCOP";
TQStringList pFunctions = SpecialInformation::functions(s);
KommanderWidget* a_atw = 0;
if (index == m_DCOP)
a_atw = dynamic_cast<KommanderWidget *>(m_widgetList[widgetComboBox->currentText()]);
int pGroup = SpecialInformation::group(s);
SpecialFunction::ParserType pType = m_useInternalParser
? SpecialFunction::InternalParser : SpecialFunction::MacroParser;
for (uint i=0; i<pFunctions.count(); i++)
{
int pFunction = SpecialInformation::function(pGroup, pFunctions[i]);
if (!SpecialInformation::isValid(pGroup, pFunction, pType))
continue;
if (a_atw && !a_atw->isFunctionSupported(pFunction) && !a_atw->isCommonFunction(pFunction))
continue;
functionListBox->insertItem(pFunctions[i]);
}
}
functionListBox->sort();
functionListBox->setCurrentItem(0);
functionChanged(functionListBox->currentItem());
}
void FunctionsDialog::functionChanged(int)
{
if (groupComboBox->currentItem() == m_Slots)
{
KommanderWidget* w = dynamic_cast<KommanderWidget *>(m_widgetList[widgetComboBox->currentText()]);
TQObject *o = w->object();
TQString slotHelp = i18n("To learn more about the slot, look at the documentation of the base TQt/KDE class, most probably <i>%1</i>.").tqarg(o->tqmetaObject()->tqsuperClassName() ? TQString(o->tqmetaObject()->tqsuperClassName()) : TQString(o->className()) );
TQString slotName = functionListBox->currentText();
TQString slot = m_slotList[slotName];
descriptionText->clear();
descriptionText->setText(i18n("<qt><h3>%1</h3>"
"<p><b>Description:</b> %2\n<p><b>Syntax:</b> <i>%3</i>%4</qt>")
.tqarg(slotName).tqarg(slotHelp).tqarg(slot).tqarg(""));
} else
{
int index = groupComboBox->currentItem();
TQString s = (index != m_DCOP ) ? groupComboBox->text(index) : "DCOP";
m_function = SpecialInformation::functionObject(s,
functionListBox->currentText());
TQString defArgs;
if (m_function.minArg() < m_function.argumentCount())
if (!m_function.minArg())
defArgs = i18n("<p>Parameters are not obligatory.");
else
defArgs = i18n("<p>Only first argument is obligatory.",
"<p>Only first %n arguments are obligatory.",
m_function.minArg());
uint pflags = SpecialFunction::ShowArgumentNames;
if (m_function.maxArg() && m_function.argumentName(0) == "widget")
pflags = pflags | SpecialFunction::SkipFirstArgument;
descriptionText->clear();
descriptionText->setText(i18n("<qt><h3>%1</h3>"
"<p><b>Description:</b> %2\n<p><b>Syntax:</b> <i>%3</i>%4</qt>")
.tqarg(functionListBox->currentText()).tqarg(m_function.description())
.tqarg(m_function.prototype(pflags)).tqarg(defArgs));
}
showParameters();
}
void FunctionsDialog::copyText()
{
TQString text = currentFunctionText();
int para, i;
insertedText->getCursorPosition(&para, &i);
// int cursorPos = insertedText->cursorPosition();
insertedText->insert(text);
insertedText->setCursorPosition(para, i + text.find('(') + 1);
}
void FunctionsDialog::showParameters()
{
KLineEdit* edits[MaxFunctionArgs] = {arg1Edit, arg2Edit, arg3Edit, arg4Edit, arg5Edit, arg6Edit};
TQLabel* labels[MaxFunctionArgs] = {argLabel1, argLabel2, argLabel3, argLabel4, argLabel5, argLabel6};
KComboBox* combos[MaxFunctionArgs] = {combo1, combo2, combo3, combo4, combo5, combo6};
TQCheckBox* quotes[MaxFunctionArgs] = {quote1, quote2, quote3, quote4, quote5, quote6};
if (groupComboBox->currentItem() == m_Slots)
{
widgetComboBox->setShown(true);
widgetLabel->setShown(true);
TQString slot = m_slotList[functionListBox->currentText()];
TQStringList slotArgs = TQStringList::split(',', slot.section(TQRegExp("\\(|\\)"), 1), false);
int argsCount = slotArgs.count();
for (int i = 0; i < MaxFunctionArgs; i++)
{
labels[i]->setShown(i < argsCount);
TQString type;
if (i < argsCount)
{
type = slotArgs[i].remove(TQRegExp("\\*|\\&|const\\s"));
labels[i]->setText(TQString("%1:").tqarg(type));
}
quotes[i]->setChecked(true);
quotes[i]->setShown(false);
if (type == "bool")
{
edits[i]->setShown(false);
combos[i]->setShown(i < argsCount);
combos[i]->clear();
combos[i]->setEditable(false);
combos[i]->insertItem("true");
combos[i]->insertItem("false");
} else
{
combos[i]->setShown(false);
edits[i]->setShown(i < argsCount);
edits[i]->clear();
if (type == TQSTRING_OBJECT_NAME_STRING)
{
quotes[i]->setShown(i < argsCount);
}
}
}
} else
{
int start = (m_function.argumentCount() && m_function.argumentName(0) == "widget");
widgetComboBox->setShown(start);
widgetLabel->setShown(start);
if (start)
{
arg1Edit->setShown(false);
argLabel1->setShown(false);
combo1->setShown(false);
quote1->setShown(false);
}
int argsCount = m_function.argumentCount();
for (int i=start; i<MaxFunctionArgs; i++)
{
labels[i]->setShown(i < argsCount);
if (i < argsCount)
labels[i]->setText(TQString("%1:").tqarg(m_function.argumentName(i)));
quotes[i]->setChecked(true);
quotes[i]->setShown(false);
if (m_function.argumentType(i) == "bool")
{
edits[i]->setShown(false);
combos[i]->setShown(i < argsCount);
combos[i]->setEditable(false);
combos[i]->clear();
combos[i]->insertItem("true");
combos[i]->insertItem("false");
} else
{
//FIXME: big hack to show a combo for createWidgets. Good solution: extra flag for arguments telling if it is a file/widget/etc.
if (m_function.name() == "createWidget" && ( i == 1 || i == 2))
{
combos[i]->clear();
combos[i]->setEditable(true);
if ( i == 1)
{
combos[i]->insertStringList(m_widgetTypes);
} else
{
combos[i]->insertItem("");
combos[i]->insertStringList(m_widgetNames);
}
edits[i]->setShown(false);
combos[i]->setShown(true);
} else
{
combos[i]->setShown(false);
edits[i]->setShown(i < argsCount);
edits[i]->clear();
if (m_function.argumentType(i) == TQSTRING_OBJECT_NAME_STRING)
{
quotes[i]->setShown(i < argsCount);
}
}
}
}
}
}
TQString FunctionsDialog::params()
{
TQLabel* labels[MaxFunctionArgs] = {argLabel1, argLabel2, argLabel3, argLabel4, argLabel5, argLabel6};
KLineEdit* edits[MaxFunctionArgs] = {arg1Edit, arg2Edit, arg3Edit, arg4Edit, arg5Edit, arg6Edit};
KComboBox* combos[MaxFunctionArgs] = {combo1, combo2, combo3, combo4, combo5, combo6};
TQStringList pars;
TQCheckBox* quotes[MaxFunctionArgs] = {quote1, quote2, quote3, quote4, quote5, quote6};
bool params = false;
bool slotsShown = (groupComboBox->currentItem() == m_Slots);
for (int i=0; i<MaxFunctionArgs; i++)
{
if (edits[i]->isShown())
{
TQString s = edits[i]->text();
if (!s.isEmpty() || i < m_function.minArg())
{
if (quotes[i]->isChecked() && ( (!slotsShown && m_function.argumentType(i) == TQSTRING_OBJECT_NAME_STRING)
|| (slotsShown && labels[i]->text().startsWith(TQSTRING_OBJECT_NAME_STRING)) ) )
s = '"' + s + '"';
pars.append(s);
}
params = true;
} else
if (combos[i]->isShown())
{
TQString s = combos[i]->currentText();
if (!s.isEmpty() || i < m_function.minArg())
{
if (s != "true" && s !="false")
s = '"' + s + '"';
pars.append(s);
}
params = true;
}
}
TQString a_param = pars.join(", ");
if (params)
return TQString("(%1)").tqarg(a_param);
else
return a_param;
}
#include "functionsimpl.moc"