mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-26 00:02:08 -05:00
f6049e01d0
- grass data item provider fixes - removed QgsProviderMetadata constructor (with std::function / PyObject) due to sip errors (api break) - reverted DataCapability move to Qgis - back to QgsDataProvider (avoiding api breaks) - WidgetMode enum documentation - sipify monkey patching fix - renamed WidgetMode's "None" to "Normal" value - in python None has special meaning (api break)
79 lines
2.9 KiB
Plaintext
79 lines
2.9 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/qgsdataitemprovider.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class QgsDataItemProvider
|
|
{
|
|
%Docstring
|
|
This is the interface for those who want to add custom data items to the browser tree.
|
|
|
|
The method createDataItem() is ever called only if capabilities() return non-zero value.
|
|
There are two occasions when createDataItem() is called:
|
|
1. to create root items (passed path is empty, parent item is ``None``).
|
|
2. to create items in directory structure. For this capabilities have to return at least
|
|
of the following: QgsDataProvider.Dir or QgsDataProvider.File. Passed path is the file
|
|
or directory being inspected, parent item is a valid QgsDirectoryItem
|
|
|
|
.. versionadded:: 2.10
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgsdataitemprovider.h"
|
|
%End
|
|
public:
|
|
virtual ~QgsDataItemProvider();
|
|
|
|
virtual QString name() = 0;
|
|
%Docstring
|
|
Human-readable name of the provider name
|
|
%End
|
|
|
|
virtual int capabilities() const = 0;
|
|
%Docstring
|
|
Returns combination of flags from QgsDataProvider.DataCapabilities
|
|
%End
|
|
|
|
virtual QgsDataItem *createDataItem( const QString &path, QgsDataItem *parentItem ) = 0 /Factory/;
|
|
%Docstring
|
|
Create a new instance of :py:class:`QgsDataItem` (or ``None``) for given path and parent item.
|
|
Caller takes responsibility of deleting created items.
|
|
%End
|
|
|
|
virtual QVector<QgsDataItem *> createDataItems( const QString &path, QgsDataItem *parentItem );
|
|
%Docstring
|
|
Create a vector of instances of :py:class:`QgsDataItem` (or ``None``) for given path and parent item.
|
|
Caller takes responsibility of deleting created items.
|
|
%End
|
|
|
|
virtual bool handlesDirectoryPath( const QString &path );
|
|
%Docstring
|
|
Returns ``True`` if the provider will handle the directory at the specified ``path``.
|
|
|
|
If the provider indicates that it will handle the directory, the default creation and
|
|
population of directory items for the path will be avoided and it is left to the
|
|
provider to correctly populate relevant entries for the path.
|
|
|
|
The default implementation returns ``False`` for all paths.
|
|
|
|
.. versionadded:: 3.0
|
|
%End
|
|
};
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/qgsdataitemprovider.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|