/* * This file is part of the KDE libraries * Copyright (C) 2003 Benjamin C Meyer (ben+kdelibs at meyerhome dot net) * Copyright (C) 2003 Waldo Bastian * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public License * along with this library; see the file COPYING.LIB. If not, write to * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, * Boston, MA 02110-1301, USA. */ #include "kconfigdialogmanager.h" #include #include #include #include #include #include #include //#include #include #include #include #include typedef QHash MyHash; K_GLOBAL_STATIC(MyHash, s_propertyMap) K_GLOBAL_STATIC(MyHash, s_changedMap) // see kdebug.areas static const int s_kconfigdialogmanagerarea = 300; class KConfigDialogManager::Private { public: Private() : insideGroupBox(false) { } public: /** * KConfigSkeleton object used to store settings */ KCoreConfigSkeleton* m_conf; /** * Dialog being managed */ QWidget* m_dialog; QHash knownWidget; QHash buddyWidget; bool insideGroupBox; bool trackChanges; }; KConfigDialogManager::KConfigDialogManager(QWidget *parent, KCoreConfigSkeleton *conf) : QObject(parent), d(new Private()) { d->m_conf = conf; d->m_dialog = parent; init(true); } KConfigDialogManager::KConfigDialogManager(QWidget *parent, KConfigSkeleton *conf) : QObject(parent), d(new Private()) { d->m_conf = conf; d->m_dialog = parent; init(true); } KConfigDialogManager::~KConfigDialogManager() { delete d; } void KConfigDialogManager::initMaps() { if (s_propertyMap->isEmpty()) { s_propertyMap->insert("QCheckBox", "checked"); s_propertyMap->insert("QPushButton", "toggled"); s_propertyMap->insert("QRadioButton", "checked"); s_propertyMap->insert("QGroupBox", "text"); // s_propertyMap->insert("QComboBox", "currentText"); s_propertyMap->insert("QDateEdit", "date"); s_propertyMap->insert("QDateTimeEdit", "dateTime"); s_propertyMap->insert("QDial", "value"); s_propertyMap->insert("QDoubleSpinBox", "value"); s_propertyMap->insert("QLineEdit", "text"); s_propertyMap->insert("QSlider", "value"); s_propertyMap->insert("QSpinBox", "value"); s_propertyMap->insert("QTextEdit", "html"); s_propertyMap->insert("QTextBrowser", "html"); s_propertyMap->insert("QPlainTextEdit", "plainText"); // s_propertyMap->insert( "QTabWidget", ""); // s_propertyMap->insert("KComboBox", "currentText"); s_propertyMap->insert("KFontRequester", "font"); s_propertyMap->insert("KHistoryCombo", "historyItems"); s_propertyMap->insert("KColorCombo", "color"); s_propertyMap->insert("KColorButton", "color"); s_propertyMap->insert("KCalendarWidget", "selectedDate"); s_propertyMap->insert("KTimeEdit", "time"); s_propertyMap->insert("KEditListWidget", "items"); // s_propertyMap->insert("KListWidget", ""); s_propertyMap->insert("KLineEdit", "text"); s_propertyMap->insert("KRestrictedLine", "text"); s_propertyMap->insert("KTextEdit", "html"); s_propertyMap->insert("KUrlRequester", "text"); s_propertyMap->insert("KUrlComboRequester", "text"); s_propertyMap->insert("KUrlComboBox", "urls"); s_propertyMap->insert("KIntNumInput", "value"); s_propertyMap->insert("KDoubleNumInput", "value"); s_propertyMap->insert("KButtonGroup", "current"); } if (s_changedMap->isEmpty()) { // Katie s_changedMap->insert("QCheckBox", SIGNAL(stateChanged(int))); s_changedMap->insert("QPushButton", SIGNAL(clicked(bool))); s_changedMap->insert("QRadioButton", SIGNAL(toggled(bool))); // can only store one thing so can't have a ButtonGroup that is checkable // s_changedMap->insert("QButtonGroup", SIGNAL(buttonClicked(int))); s_changedMap->insert("QGroupBox", SIGNAL(toggled(bool))); s_changedMap->insert("QComboBox", SIGNAL(activated(int))); // s_changedMap->insert("QComboBox", SIGNAL(textChanged(QString))); s_changedMap->insert("QDateEdit", SIGNAL(dateChanged(QDate))); s_changedMap->insert("QDateTimeEdit", SIGNAL(timeChanged(QTime))); s_changedMap->insert("QDateTimeEdit", SIGNAL(dateTimeChanged(QDateTime))); s_changedMap->insert("QDial", SIGNAL(valueChanged(int))); s_changedMap->insert("QDoubleSpinBox", SIGNAL(valueChanged(double))); s_changedMap->insert("QLineEdit", SIGNAL(textChanged(QString))); s_changedMap->insert("QSlider", SIGNAL(valueChanged(int))); s_changedMap->insert("QSpinBox", SIGNAL(valueChanged(int))); s_changedMap->insert("QTextEdit", SIGNAL(textChanged())); s_changedMap->insert("QTextBrowser", SIGNAL(sourceChanged(QString))); s_changedMap->insert("QPlainTextEdit", SIGNAL(textChanged())); s_changedMap->insert("QTabWidget", SIGNAL(currentChanged(int))); // KDE s_changedMap->insert("KComboBox", SIGNAL(activated(int))); s_changedMap->insert("KFontRequester", SIGNAL(fontSelected(QFont))); s_changedMap->insert("KHistoryCombo", SIGNAL(activated(int))); s_changedMap->insert("KColorCombo", SIGNAL(activated(QColor))); s_changedMap->insert("KColorButton", SIGNAL(changed(QColor))); s_changedMap->insert("KCalendarWidget", SIGNAL(activated(QDate))); s_changedMap->insert("KTimeEdit", SIGNAL(timeChanged(QTime))); s_changedMap->insert("KEditListWidget", SIGNAL(changed())); s_changedMap->insert("KListWidget", SIGNAL(itemSelectionChanged())); s_changedMap->insert("KLineEdit", SIGNAL(textChanged(QString))); s_changedMap->insert("KRestrictedLine", SIGNAL(textChanged(QString))); s_changedMap->insert("KTextEdit", SIGNAL(textChanged())); s_changedMap->insert("KUrlRequester", SIGNAL(textChanged(QString))); s_changedMap->insert("KUrlComboRequester", SIGNAL(textChanged(QString))); s_changedMap->insert("KUrlComboBox", SIGNAL(urlActivated(KUrl))); s_changedMap->insert("KIntNumInput", SIGNAL(valueChanged(int))); s_changedMap->insert("KDoubleNumInput", SIGNAL(valueChanged(double))); s_changedMap->insert("KButtonGroup", SIGNAL(changed(int))); } } QHash *KConfigDialogManager::propertyMap() { initMaps(); return s_propertyMap; } QHash *KConfigDialogManager::changedMap() { initMaps(); return s_changedMap; } void KConfigDialogManager::init(bool trackChanges) { initMaps(); d->trackChanges = trackChanges; // Go through all of the children of the widgets and find all known widgets (void) parseChildren(d->m_dialog, trackChanges); } void KConfigDialogManager::addWidget(QWidget *widget) { (void) parseChildren(widget, true); } void KConfigDialogManager::setupWidget(QWidget *widget, KConfigSkeletonItem *item) { QVariant minValue = item->minValue(); if (minValue.isValid()) { // Only q3datetimeedit is using this property we can remove it if we stop supporting Qt3Support if (widget->metaObject()->indexOfProperty("minValue") != -1) { widget->setProperty("minValue", minValue); } if (widget->metaObject()->indexOfProperty("minimum") != -1) { widget->setProperty("minimum", minValue); } } QVariant maxValue = item->maxValue(); if (maxValue.isValid()) { // Only q3datetimeedit is using that property we can remove it if we stop supporting Qt3Support if (widget->metaObject()->indexOfProperty("maxValue") != -1) { widget->setProperty("maxValue", maxValue); } if (widget->metaObject()->indexOfProperty("maximum") != -1) { widget->setProperty("maximum", maxValue); } } if (widget->whatsThis().isEmpty()) { QString whatsThis = item->whatsThis(); if (!whatsThis.isEmpty()) { widget->setWhatsThis(whatsThis); } } if (widget->toolTip().isEmpty()) { QString toolTip = item->toolTip(); if (!toolTip.isEmpty()) { widget->setToolTip(toolTip); } } if (!item->isEqual(property(widget))) { setProperty(widget, item->property()); } } bool KConfigDialogManager::parseChildren(const QWidget *widget, bool trackChanges) { bool valueChanged = false; const QList listOfChildren = widget->children(); if (listOfChildren.count() == 0) { return valueChanged; } foreach (QObject *object, listOfChildren) { if(!object->isWidgetType()) { // Skip non-widgets continue; } QWidget *childWidget = static_cast(object); QString widgetName = childWidget->objectName(); bool bParseChildren = true; bool bSaveInsideGroupBox = d->insideGroupBox; if (widgetName.startsWith(QLatin1String("kcfg_"))) { // This is one of our widgets! QString configId = widgetName.mid(5); KConfigSkeletonItem *item = d->m_conf->findItem(configId); if (item) { d->knownWidget.insert(configId, childWidget); setupWidget(childWidget, item); if (d->trackChanges) { QHash::const_iterator changedIt = s_changedMap->constFind(childWidget->metaObject()->className()); if (changedIt == s_changedMap->constEnd()) { // If the class name of the widget wasn't in the monitored widgets map, then look for // it again using the super class name. This fixes a problem with using QtRuby/Korundum // widgets with KConfigXT where 'Qt::Widget' wasn't being seen a the real deal, even // though it was a 'QWidget'. if ( childWidget->metaObject()->superClass()) { changedIt = s_changedMap->constFind(childWidget->metaObject()->superClass()->className()); } else { changedIt = s_changedMap->constFind(QString()); } } if (changedIt == s_changedMap->constEnd()) { kWarning(s_kconfigdialogmanagerarea) << "Don't know how to monitor widget '" << childWidget->metaObject()->className() << "' for changes!"; } else { connect(childWidget, *changedIt, this, SIGNAL(widgetModified())); QComboBox *cb = qobject_cast(childWidget); if (cb && cb->isEditable()) connect(cb, SIGNAL(editTextChanged(QString)), this, SIGNAL(widgetModified())); } } QGroupBox *gb = qobject_cast(childWidget); if (!gb) { bParseChildren = false; } else { d->insideGroupBox = true; } } else { kWarning(s_kconfigdialogmanagerarea) << "A widget named '" << widgetName << "' was found but there is no setting named '" << configId << "'"; } } else if (QLabel *label = qobject_cast(childWidget)) { QWidget *buddy = label->buddy(); if (!buddy) { continue; } QString buddyName = buddy->objectName(); if (buddyName.startsWith(QLatin1String("kcfg_"))) { // This is one of our widgets! QString configId = buddyName.mid(5); d->buddyWidget.insert(configId, childWidget); } } #ifndef NDEBUG else if (!widgetName.isEmpty() && d->trackChanges) { QHash::const_iterator changedIt = s_changedMap->constFind(childWidget->metaObject()->className()); if (changedIt != s_changedMap->constEnd()) { if ((!d->insideGroupBox || !qobject_cast(childWidget)) && !qobject_cast(childWidget) &&!qobject_cast(childWidget)) { kDebug(s_kconfigdialogmanagerarea) << "Widget '" << widgetName << "' (" << childWidget->metaObject()->className() << ") remains unmanaged."; } } } #endif if (bParseChildren) { // this widget is not known as something we can store. // Maybe we can store one of its children. valueChanged |= parseChildren(childWidget, trackChanges); } d->insideGroupBox = bSaveInsideGroupBox; } return valueChanged; } void KConfigDialogManager::updateWidgets() { bool changed = false; bool bSignalsBlocked = signalsBlocked(); blockSignals(true); QWidget *widget; QHashIterator it(d->knownWidget); while(it.hasNext()) { it.next(); widget = it.value(); KConfigSkeletonItem* item = d->m_conf->findItem(it.key()); if (!item) { kWarning(s_kconfigdialogmanagerarea) << "The setting '" << it.key() << "' has disappeared!"; continue; } if (!item->isEqual(property(widget))) { setProperty(widget, item->property()); // kDebug(s_kconfigdialogmanagerarea) << "The setting '" << it.key() << "' [" << widget->className() << "] has changed"; changed = true; } if (item->isImmutable()) { widget->setEnabled(false); QWidget *buddy = d->buddyWidget.value(it.key(), 0); if (buddy) { buddy->setEnabled(false); } } } blockSignals(bSignalsBlocked); if (changed) { QTimer::singleShot(0, this, SIGNAL(widgetModified())); } } void KConfigDialogManager::updateWidgetsDefault() { bool bUseDefaults = d->m_conf->useDefaults(true); updateWidgets(); d->m_conf->useDefaults(bUseDefaults); } void KConfigDialogManager::updateSettings() { bool changed = false; QWidget *widget; QHashIterator it(d->knownWidget); while(it.hasNext()) { it.next(); widget = it.value(); KConfigSkeletonItem *item = d->m_conf->findItem(it.key()); if (!item) { kWarning(s_kconfigdialogmanagerarea) << "The setting '" << it.key() << "' has disappeared!"; continue; } QVariant fromWidget = property(widget); if(!item->isEqual(fromWidget)) { item->setProperty( fromWidget ); changed = true; } } if (changed) { d->m_conf->writeConfig(); emit settingsChanged(); } } QByteArray KConfigDialogManager::getCustomProperty(const QWidget *widget) const { QVariant prop(widget->property("kcfg_property")); if (prop.isValid()) { if (!prop.canConvert(QVariant::ByteArray)) { kWarning(s_kconfigdialogmanagerarea) << "kcfg_property on" << widget->metaObject()->className() << "is not of type ByteArray"; } else { return prop.toByteArray(); } } return QByteArray(); } void KConfigDialogManager::setProperty(QWidget *w, const QVariant &v) { QByteArray customproperty = getCustomProperty(w); if (customproperty.isEmpty()) { customproperty = s_propertyMap->value(w->metaObject()->className()); } if (customproperty.isEmpty()) { QComboBox *cb = qobject_cast(w); if (cb) { if (cb->isEditable()) { int i = cb->findText(v.toString()); if (i != -1) { cb->setCurrentIndex(i); } else { cb->setEditText(v.toString()); } } else { cb->setCurrentIndex(v.toInt()); } return; } } if (customproperty.isEmpty()) { kWarning(s_kconfigdialogmanagerarea) << w->metaObject()->className() << " widget not handled!"; return; } w->setProperty(customproperty, v); } QVariant KConfigDialogManager::property(QWidget *w) const { QByteArray customproperty = getCustomProperty(w); if (customproperty.isEmpty()) { customproperty = s_propertyMap->value(w->metaObject()->className()); } if (customproperty.isEmpty()) { QComboBox *cb = qobject_cast(w); if (cb) { if (cb->isEditable()) { return QVariant(cb->currentText()); } else { return QVariant(cb->currentIndex()); } } } if (customproperty.isEmpty()) { kWarning(s_kconfigdialogmanagerarea) << w->metaObject()->className() << " widget not handled!"; return QVariant(); } return w->property(customproperty); } bool KConfigDialogManager::hasChanged() const { QWidget *widget; QHashIterator it(d->knownWidget); while(it.hasNext()) { it.next(); widget = it.value(); KConfigSkeletonItem *item = d->m_conf->findItem(it.key()); if (!item) { kWarning(s_kconfigdialogmanagerarea) << "The setting '" << it.key() << "' has disappeared!"; continue; } if(!item->isEqual( property(widget))) { // kDebug(s_kconfigdialogmanagerarea) << "Widget for '" << it.key() << "' has changed."; return true; } } return false; } bool KConfigDialogManager::isDefault() const { bool bUseDefaults = d->m_conf->useDefaults(true); bool result = !hasChanged(); d->m_conf->useDefaults(bUseDefaults); return result; } #include "moc_kconfigdialogmanager.cpp"