/usr/include/qgis/qgseditorwidgetregistry.h is in libqgis-dev 2.4.0-1+b1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 | /***************************************************************************
qgseditorwidgetregistry.h
--------------------------------------
Date : 24.4.2013
Copyright : (C) 2013 Matthias Kuhn
Email : matthias dot kuhn at gmx dot ch
***************************************************************************
* *
* 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. *
* *
***************************************************************************/
#ifndef QGSEDITORWIDGETREGISTRY_H
#define QGSEDITORWIDGETREGISTRY_H
#include <QObject>
#include <QMap>
#include "qgseditorwidgetfactory.h"
class QgsMapLayer;
class QDomNode;
/**
* This class manages all known edit widget factories
*/
class GUI_EXPORT QgsEditorWidgetRegistry : public QObject
{
Q_OBJECT
public:
/**
* This class is a singleton and has therefore to be accessed with this method instead
* of a constructor.
*
* @return
*/
static QgsEditorWidgetRegistry* instance();
~QgsEditorWidgetRegistry();
/**
* Create an attribute editor widget wrapper of a given type for a given field.
* The editor may be NULL if you want the widget wrapper to create a default widget.
*
* @param widgetId The id of the widget type to create an attribute editor for
* @param vl The vector layer for which this widget will be created
* @param fieldIdx The field index on the specified layer for which this widget will be created
* @param config A configuration which should be used for the widget creation
* @param editor An editor widget which will be used instead of an autocreated widget
* @param parent The parent which will be used for the created wrapper and the created widget
*
* @return A new widget wrapper
*/
QgsEditorWidgetWrapper* create( const QString& widgetId, QgsVectorLayer* vl, int fieldIdx, const QgsEditorWidgetConfig& config, QWidget* editor, QWidget* parent, const QgsAttributeEditorContext context = QgsAttributeEditorContext() );
/**
* Creates a configuration widget
*
* @param widgetId The id of the widget type to create a configuration widget for
* @param vl The vector layer for which this widget will be created
* @param fieldIdx The field index on the specified layer for which this widget will be created
* @param parent The parent widget for the created widget
*
* @return A new configuration widget
*/
QgsEditorConfigWidget* createConfigWidget( const QString& widgetId, QgsVectorLayer* vl, int fieldIdx, QWidget* parent );
/**
* Get the human readable name for a widget type
*
* @param widgetId The widget type to get the name for
*
* @return A human readable name
*/
QString name( const QString& widgetId );
/**
* Get access to all registered factories
*
* @return All ids and factories
*/
const QMap<QString, QgsEditorWidgetFactory*>& factories();
/**
* Get a factory for the given widget type id.
*
* @return A factory or Null if not existent
*/
QgsEditorWidgetFactory* factory( const QString& widgetId );
/**
* Register a new widget factory with the given id
*
* @param widgetId The id which will be used later to refer to this widget type
* @param widgetFactory The factory which will create this widget type
*
* @return true, if successful, false, if the widgetId is already in use or widgetFactory is NULL
*/
bool registerWidget( const QString& widgetId, QgsEditorWidgetFactory* widgetFactory );
protected:
QgsEditorWidgetRegistry();
private slots:
/**
* Read all the editor widget information from a map layer XML node
* @param mapLayer
* @param layerElem
*/
void readMapLayer( QgsMapLayer* mapLayer , const QDomElement& layerElem );
/**
* Read all old-style editor widget configuration from a map node. Will update
* a project file to the new version on next save
* @param mapLayer The layer in question
* @param layerElem The layer element from the project file
* @param cfg Writable config element
*
* @deprecated
*/
Q_DECL_DEPRECATED const QString readLegacyConfig( QgsVectorLayer* vl, const QDomElement& editTypeElement , QgsEditorWidgetConfig& cfg );
/**
* Write all the widget config to a layer XML node
*
* @param mapLayer The layer for which the config is being written
* @param layerElem The XML element to which the config will be written
* @param doc The document from which to create elements
*/
void writeMapLayer( QgsMapLayer* mapLayer , QDomElement& layerElem, QDomDocument& doc );
private:
QMap<QString, QgsEditorWidgetFactory*> mWidgetFactories;
};
#endif // QGSEDITORWIDGETREGISTRY_H
|