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.
214 lines
8.0 KiB
214 lines
8.0 KiB
/* This file is part of the KDE project
|
|
Copyright (C) 2003 Lucijan Busch <lucijan@gmx.at>
|
|
Copyright (C) 2004 Cedric Pasteur <cedric.pasteur@free.fr>
|
|
Copyright (C) 2004-2007 Jaroslaw Staniek <js@iidea.pl>
|
|
|
|
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.
|
|
*/
|
|
|
|
#ifndef KFORMDESIGNERWIDGETLIBRARY_H
|
|
#define KFORMDESIGNERWIDGETLIBRARY_H
|
|
|
|
#include <tqobject.h>
|
|
#include <tqmap.h>
|
|
#include <tqdict.h>
|
|
|
|
#include "widgetfactory.h"
|
|
|
|
template<class type> class TQPtrList;
|
|
template<class type> class TQValueVector;
|
|
class KActionCollection;
|
|
class KAction;
|
|
class TQWidget;
|
|
class TQPopupMenu;
|
|
class TQVariant;
|
|
class TQDomDocument;
|
|
class TQDomElement;
|
|
|
|
namespace KFormDesigner {
|
|
|
|
class Container;
|
|
class ObjectTreeItem;
|
|
class WidgetLibraryPrivate;
|
|
class WidgetPropertySet;
|
|
|
|
typedef TQPtrList<KAction> ActionList;
|
|
|
|
/**
|
|
* This class searches for factories and provides KActions for widget creation.
|
|
* Every widget can be located using this library.
|
|
* You call WidgetLibrary functions instead of calling directly factories.
|
|
* See WidgetFactory for a description of the functions.
|
|
*/
|
|
class KFORMEDITOR_EXPORT WidgetLibrary : public TQObject
|
|
{
|
|
Q_OBJECT
|
|
TQ_OBJECT
|
|
|
|
public:
|
|
/*! Constructs WidgetLibrary object.
|
|
In \a supportedFactoryGroups you can provide
|
|
factory group list to be supported. Factory groups are defined by
|
|
"X-KFormDesigner-FactoryGroup" field in every factory serviece's .desktop file.
|
|
By default (when supportedFactoryGroups is empty) only factories having empty
|
|
"X-KFormDesigner-FactoryGroup" field will be loaded.
|
|
Factory group names are case-insensitive. */
|
|
WidgetLibrary(TQObject *parent=0, const TQStringList& supportedFactoryGroups = TQStringList());
|
|
|
|
virtual ~WidgetLibrary();
|
|
|
|
/**
|
|
* creates actions for widget creating
|
|
*/
|
|
ActionList createWidgetActions(KXMLGUIClient* client, KActionCollection *parent,
|
|
TQObject *receiver, const char *slot);
|
|
|
|
void addCustomWidgetActions(KActionCollection *col);
|
|
|
|
//old /**
|
|
//old * creates the XML for widget actions
|
|
//old */
|
|
//old TQString createXML();
|
|
|
|
/**
|
|
* searches the right factory and creates a widget.
|
|
* \return the widget or 0 if something falid
|
|
*/
|
|
TQWidget *createWidget(const TQCString &classname, TQWidget *parent, const char *name, Container *c,
|
|
int options = WidgetFactory::DefaultOptions);
|
|
|
|
bool createMenuActions(const TQCString &c, TQWidget *w, TQPopupMenu *menu,
|
|
KFormDesigner::Container *container);
|
|
|
|
/**
|
|
* Shows orientation selection popup.
|
|
* \return one of the following values:
|
|
* - WidgetFactory::AnyQt::Orientation (means no selection has been made, i.e. it was cancelled)
|
|
* - WidgetFactory::HorizontalQt::Orientation
|
|
* - WidgetFactory::VerticalQt::Orientation
|
|
*/
|
|
WidgetFactory::CreateWidgetOptions showOrientationSelectionPopup(
|
|
const TQCString &classname, TQWidget* parent, const TQPoint& pos);
|
|
|
|
TQString internalProperty(const TQCString& classname, const TQCString& property);
|
|
|
|
TQString displayName(const TQCString &classname);
|
|
TQString namePrefix(const TQCString &classname);
|
|
TQString textForWidgetName(const TQCString &name, const TQCString &className);
|
|
|
|
/*! Checks if the \a classname is an alternate classname,
|
|
and returns the good classname.
|
|
If \a classname is not alternate, \a classname is returned. */
|
|
TQCString classNameForAlternate(const TQCString &classname);
|
|
TQString iconName(const TQCString &classname);
|
|
TQString includeFileName(const TQCString &classname);
|
|
TQString savingName(const TQCString &classname);
|
|
|
|
bool startEditing(const TQCString &classname, TQWidget *w, Container *container);
|
|
bool previewWidget(const TQCString &classname, TQWidget *widget, Container *container);
|
|
bool clearWidgetContent(const TQCString &classname, TQWidget *w);
|
|
|
|
bool saveSpecialProperty(const TQCString &classname, const TQString &name,
|
|
const TQVariant &value, TQWidget *w, TQDomElement &parentNode, TQDomDocument &parent);
|
|
bool readSpecialProperty(const TQCString &classname, TQDomElement &node, TQWidget *w,
|
|
ObjectTreeItem *item);
|
|
bool isPropertyVisible(const TQCString &classname, TQWidget *w,
|
|
const TQCString &property, bool multiple = false, bool isTopLevel = false);
|
|
|
|
TQValueList<TQCString> autoSaveProperties(const TQCString &classname);
|
|
|
|
WidgetInfo* widgetInfoForClassName(const char* classname);
|
|
|
|
WidgetFactory* factoryForClassName(const char* className);
|
|
|
|
WidgetFactory* factory(const char* factoryName) const;
|
|
|
|
/*! \return true if advanced properties like "mouseTracking" should
|
|
be user-visible. True by default (in KFD), but Kexi set's this to false.
|
|
See WidgetLibraryPrivate class implementation for complete list
|
|
of advanced properties. */
|
|
bool advancedPropertiesVisible() const;
|
|
|
|
/*! Sets advanced properties to be visible or not. */
|
|
void setAdvancedPropertiesVisible(bool set);
|
|
|
|
/*! \return The i18n'ed name of the property \a propertyName
|
|
for a class described by \a winfo. The name can be displayed in
|
|
PropertyEditor. The name is retrieved from class' widget library.
|
|
If this library doesn't define description for such property,
|
|
and there is a parent library for \a winfo defined, parent library
|
|
is asked for returning description string.
|
|
Eventually, if even this failed, empty string is returned.
|
|
@see WidgetFactory::propertyDescForName() */
|
|
TQString propertyDescForName(WidgetInfo *winfo, const TQCString& propertyName);
|
|
|
|
/*! \return The i18n'ed name of the property's value whose name is \a name.
|
|
Works in the same way as propertyDescForName(): if actual library
|
|
does not define a description we are looking for, parent factory is asked
|
|
to return such description.
|
|
Eventually, if even this failed, empty string is returned.
|
|
@see WidgetFactory::propertyDescForValue() */
|
|
TQString propertyDescForValue(WidgetInfo *winfo, const TQCString& name);
|
|
|
|
/*! Used by WidgetPropertySet::setWidget() after creating properties. */
|
|
void setPropertyOptions( WidgetPropertySet &list, const WidgetInfo& winfo, TQWidget* w );
|
|
|
|
/*! \return true if property sets should be reloaded for \a property property,
|
|
\a classname class and widget \a w when a given property value changed. */
|
|
bool propertySetShouldBeReloadedAfterPropertyChange(const TQCString& classname, TQWidget *w,
|
|
const TQCString& property);
|
|
|
|
signals:
|
|
void prepareInsert(const TQCString &c);
|
|
|
|
//! Received by KexiFormPart::slotWidgetCreatedByFormsLibrary() so we can add drag/drop
|
|
//! connection for the new widget
|
|
void widgetCreated(TQWidget *widget);
|
|
|
|
protected:
|
|
/**
|
|
* Adds a factory to the library, creates actions for widgets in the added factory.
|
|
* This function is not called directly but by the factory locater.
|
|
*/
|
|
void loadFactoryWidgets(WidgetFactory *f);
|
|
|
|
#if 0 //UNIMPLEMENTED
|
|
/**
|
|
* you can restrict the loaded factories by setting the filter to a pattern
|
|
* like 'kexi|containers' in that case only factory containing 'kexi' or containers will be loaded.
|
|
* this is useful if you want to embedd formeditor and provide e.g. a LineEdit with special features
|
|
* but don't want to confuse the user... are you confused now?
|
|
* NB: not implemented yet
|
|
*/
|
|
void setFilter(const TQRegExp &expr);
|
|
#endif
|
|
|
|
/**
|
|
* Lookups widget factories list (note that this function get called once in ctor)
|
|
*/
|
|
void lookupFactories();
|
|
|
|
/**
|
|
* Loads widget factories found in lookupFactories(). This is called once.
|
|
*/
|
|
void loadFactories();
|
|
|
|
WidgetLibraryPrivate *d;
|
|
};
|
|
|
|
}
|
|
#endif
|