|
| 1 | +/************************************************************************ |
| 2 | + * This file has been generated automatically from * |
| 3 | + * * |
| 4 | + * src/gui/layertree/qgslayertreeembeddedwidgetregistry.h * |
| 5 | + * * |
| 6 | + * Do not edit manually ! Edit header and run scripts/sipify.pl again * |
| 7 | + ************************************************************************/ |
| 8 | + |
| 9 | + |
| 10 | + |
| 11 | + |
1 | 12 |
|
2 | | -/** \ingroup gui |
3 | | - * \class QgsLayerTreeEmbeddedWidgetProvider |
4 | | - * Provider interface to be implemented in order to introduce new kinds of embedded widgets for use in layer tree. |
5 | | - * Embedded widgets are assigned per individual map layers and they are shown before any legend entries. |
6 | | - * @see QgsLayerTreeEmbeddedWidgetRegistry |
7 | | - * @note introduced in QGIS 2.16 |
8 | | - */ |
9 | 13 | class QgsLayerTreeEmbeddedWidgetProvider |
10 | 14 | { |
11 | | -%TypeHeaderCode |
12 | | -#include <qgslayertreeembeddedwidgetregistry.h> |
| 15 | +%Docstring |
| 16 | + Provider interface to be implemented in order to introduce new kinds of embedded widgets for use in layer tree. |
| 17 | + Embedded widgets are assigned per individual map layers and they are shown before any legend entries. |
| 18 | +.. seealso:: QgsLayerTreeEmbeddedWidgetRegistry |
| 19 | +.. versionadded:: 2.16 |
13 | 20 | %End |
14 | 21 |
|
| 22 | +%TypeHeaderCode |
| 23 | +#include "qgslayertreeembeddedwidgetregistry.h" |
| 24 | +%End |
15 | 25 | public: |
16 | 26 | virtual ~QgsLayerTreeEmbeddedWidgetProvider(); |
17 | 27 |
|
18 | | - //! Unique name of the provider (among other providers) |
19 | 28 | virtual QString id() const = 0; |
| 29 | +%Docstring |
| 30 | +Unique name of the provider (among other providers) |
| 31 | + :rtype: str |
| 32 | +%End |
20 | 33 |
|
21 | | - //! Human readable name - may be translatable with tr() |
22 | 34 | virtual QString name() const = 0; |
| 35 | +%Docstring |
| 36 | +Human readable name - may be translatable with tr() |
| 37 | + :rtype: str |
| 38 | +%End |
23 | 39 |
|
24 | | - //! Factory to create widgets. The returned widget is owned by the caller. |
25 | | - //! The widgetIndex argument may be used to identify which widget is being |
26 | | - //! created (useful when using multiple widgets from the same provider for one layer). |
27 | 40 | virtual QWidget *createWidget( QgsMapLayer *layer, int widgetIndex ) = 0 /Factory/; |
| 41 | +%Docstring |
| 42 | +created (useful when using multiple widgets from the same provider for one layer). |
| 43 | + :rtype: QWidget |
| 44 | +%End |
28 | 45 |
|
29 | | - //! Whether it makes sense to use this widget for a particular layer |
30 | 46 | virtual bool supportsLayer( QgsMapLayer *layer ) = 0; |
| 47 | +%Docstring |
| 48 | +Whether it makes sense to use this widget for a particular layer |
| 49 | + :rtype: bool |
| 50 | +%End |
31 | 51 | }; |
32 | 52 |
|
33 | | -/** \ingroup gui |
34 | | - * \class QgsLayerTreeEmbeddedWidgetRegistry |
35 | | - * Registry of widgets that may be embedded into layer tree view. |
36 | | - * Embedded widgets are assigned per individual map layers and they are shown before any legend entries. |
37 | | - * Layer tree must have UseEmbeddedWidgets flag enabled in order to show assigned widgets. |
38 | | - * |
39 | | - * @see QgsLayerTreeEmbeddedWidgetRegistry |
40 | | - * @note introduced in QGIS 2.16 |
41 | | - */ |
42 | 53 | class QgsLayerTreeEmbeddedWidgetRegistry |
43 | 54 | { |
44 | | -%TypeHeaderCode |
45 | | -#include <qgslayertreeembeddedwidgetregistry.h> |
| 55 | +%Docstring |
| 56 | + Registry of widgets that may be embedded into layer tree view. |
| 57 | + Embedded widgets are assigned per individual map layers and they are shown before any legend entries. |
| 58 | + Layer tree must have UseEmbeddedWidgets flag enabled in order to show assigned widgets. |
| 59 | + |
| 60 | + QgsLayerTreeEmbeddedWidgetRegistry is not usually directly created, but rather accessed through |
| 61 | + QgsGui.layerTreeEmbeddedWidgetRegistry(). |
| 62 | + |
| 63 | +.. seealso:: QgsLayerTreeEmbeddedWidgetRegistry |
| 64 | +.. versionadded:: 2.16 |
46 | 65 | %End |
47 | 66 |
|
| 67 | +%TypeHeaderCode |
| 68 | +#include "qgslayertreeembeddedwidgetregistry.h" |
| 69 | +%End |
48 | 70 | public: |
49 | 71 |
|
50 | 72 | QgsLayerTreeEmbeddedWidgetRegistry(); |
| 73 | +%Docstring |
| 74 | + Constructor for QgsLayerTreeEmbeddedWidgetRegistry |
| 75 | + |
| 76 | + QgsLayerTreeEmbeddedWidgetRegistry is not usually directly created, but rather accessed through |
| 77 | + QgsGui.layerTreeEmbeddedWidgetRegistry(). |
| 78 | +%End |
51 | 79 |
|
52 | 80 | ~QgsLayerTreeEmbeddedWidgetRegistry(); |
53 | 81 |
|
54 | | - /** Return list of all registered providers */ |
| 82 | + |
55 | 83 | QStringList providers() const; |
| 84 | +%Docstring |
| 85 | +Return list of all registered providers |
| 86 | + :rtype: list of str |
| 87 | +%End |
56 | 88 |
|
57 | | - /** Get provider object from the provider's ID */ |
58 | 89 | QgsLayerTreeEmbeddedWidgetProvider *provider( const QString &providerId ) const; |
| 90 | +%Docstring |
| 91 | +Get provider object from the provider's ID |
| 92 | + :rtype: QgsLayerTreeEmbeddedWidgetProvider |
| 93 | +%End |
59 | 94 |
|
60 | | - /** Register a provider, takes ownership of the object. |
61 | | - * Returns true on success, false if the provider is already registered. */ |
62 | 95 | bool addProvider( QgsLayerTreeEmbeddedWidgetProvider *provider /Transfer/ ); |
| 96 | +%Docstring |
| 97 | + Register a provider, takes ownership of the object. |
| 98 | + Returns true on success, false if the provider is already registered. * |
| 99 | + :rtype: bool |
| 100 | +%End |
63 | 101 |
|
64 | | - /** Unregister a provider, the provider object is deleted. |
65 | | - * Returns true on success, false if the provider was not registered. */ |
66 | 102 | bool removeProvider( const QString &providerId ); |
| 103 | +%Docstring |
| 104 | + Unregister a provider, the provider object is deleted. |
| 105 | + Returns true on success, false if the provider was not registered. * |
| 106 | + :rtype: bool |
| 107 | +%End |
| 108 | +
|
| 109 | + protected: |
67 | 110 |
|
68 | | - private: |
69 | 111 |
|
| 112 | + private: |
70 | 113 | QgsLayerTreeEmbeddedWidgetRegistry( const QgsLayerTreeEmbeddedWidgetRegistry &other ); |
71 | 114 | }; |
| 115 | +
|
| 116 | +
|
| 117 | +/************************************************************************ |
| 118 | + * This file has been generated automatically from * |
| 119 | + * * |
| 120 | + * src/gui/layertree/qgslayertreeembeddedwidgetregistry.h * |
| 121 | + * * |
| 122 | + * Do not edit manually ! Edit header and run scripts/sipify.pl again * |
| 123 | + ************************************************************************/ |
0 commit comments