/** Animated icon is keeping an animation running if there are listeners connected to frameChanged */ class QgsAnimatedIcon : QObject { %TypeHeaderCode #include %End public: /** Constructor * @param iconPath path to a movie, e.g. animated GIF */ QgsAnimatedIcon( const QString & iconPath = QString::null ); QString iconPath() const; void setIconPath( const QString & iconPath ); QIcon icon() const; /** Connect listener to frameChanged() signal */ void connectFrameChanged( const QObject * receiver, const char * method ); /** Disconnect listener from frameChanged() signal */ void disconnectFrameChanged( const QObject * receiver, const char * method ); public slots: void onFrameChanged(); signals: /** Emitted when icon changed */ void frameChanged(); }; class QgsDataItem : QObject { %TypeHeaderCode #include %End %ConvertToSubClassCode if (qobject_cast(sipCpp)) sipType = sipType_QgsLayerItem; else if (qobject_cast(sipCpp)) sipType = sipType_QgsErrorItem; else if (qobject_cast(sipCpp)) sipType = sipType_QgsDirectoryItem; else if (qobject_cast(sipCpp)) sipType = sipType_QgsFavouritesItem; else if (qobject_cast(sipCpp)) sipType = sipType_QgsZipItem; else if (qobject_cast(sipCpp)) sipType = sipType_QgsDataCollectionItem; else sipType = 0; %End public: enum Type { Collection, Directory, Layer, Error, Favourites }; /** Create new data item. */ QgsDataItem( QgsDataItem::Type type, QgsDataItem* parent /TransferThis/, const QString& name, const QString& path ); virtual ~QgsDataItem(); bool hasChildren(); int rowCount(); /** Create children. Children are not expected to have parent set. * This method MUST BE THREAD SAFE. */ virtual QVector createChildren(); enum State { NotPopulated, //!< Children not yet created Populating, //!< Creating children in separate thread (populating or refreshing) Populated //!< children created }; //! @note added in 2.8 State state() const; /** Set item state. It also take care about starting/stopping loading icon animation. * @param state * @note added in 2.8 */ virtual void setState( State state ); //! @deprecated in 2.8, use state() bool isPopulated() /Deprecated/; // Insert new child using alphabetical order based on mName, emits necessary signal to model before and after, sets parent and connects signals // refresh - refresh populated item, emit signals to model virtual void addChildItem( QgsDataItem *child /Transfer/, bool refresh = false ); // remove and delete child item, signals to browser are emitted virtual void deleteChildItem( QgsDataItem * child ); // remove child item but don't delete it, signals to browser are emitted // returns pointer to the removed item or null if no such item was found virtual QgsDataItem *removeChildItem( QgsDataItem * child ) /TransferBack/; virtual bool equal( const QgsDataItem *other ); virtual QWidget *paramWidget() /Factory/; // list of actions provided by this item - usually used for popup menu on right-click virtual QList actions(); // whether accepts drag&drop'd layers - e.g. for import virtual bool acceptDrop(); // try to process the data dropped on this item virtual bool handleDrop( const QMimeData * /*data*/, Qt::DropAction /*action*/ ); enum Capability { NoCapabilities, SetCrs, //!< Can set CRS on layer or group of layers Fertile, //!< Can create children. Even items without this capability may have children, but cannot create them, it means that children are created by item ancestors. Fast //!< createChildren() is fast enough to be run in main thread when refreshing items, most root items (wms,wfs,wcs,postgres...) are considered fast because they are reading data only from QSettings }; typedef QFlags Capabilities; // This will _write_ selected crs in data source virtual bool setCrs( QgsCoordinateReferenceSystem crs ); //! @deprecated since 2.8, returned type this will changed to Capabilities virtual Capability capabilities() /Deprecated/; virtual Capabilities capabilities2() const; virtual void setCapabilities( const Capabilities& capabilities ); // static methods // Find child index in vector of items using '==' operator static int findItem( QVector items, QgsDataItem * item ); // members Type type() const; /** Get item parent. QgsDataItem maintains its own items hierarchy, it does not use * QObject hierarchy. */ QgsDataItem* parent() const; /** Set item parent and connect / disconnect parent to / from item signals. * It does not add itself to parents children (mChildren) */ void setParent( QgsDataItem* parent ); QVector children() const; QIcon icon(); QString name() const; void setName( const QString &name ); QString path() const; void setPath( const QString ); //! Create path component replacing path separators static QString pathComponent( const QString &component ); // Because QIcon (QPixmap) must not be used in outside the GUI thread, it is // not possible to set mIcon in constructor. Either use mIconName/setIconName() // or implement icon(). void setIcon( const QIcon& icon ); void setIconName( const QString & iconName ); void setToolTip( const QString& msg ); QString toolTip() const; // deleteLater() items anc clear the vector static void deleteLater( QVector &items ); /** Move object and all its descendants to thread */ void moveToThread( QThread * targetThread ); protected: virtual void populate( const QVector& children ); virtual void refresh( QVector children ); /** The item is scheduled to be deleted. E.g. if deleteLater() is called when * item is in Populating state (createChildren() running in another thread), * the deferredDelete() returns true and item will be deleted once Populating finished. * Items with slow reateChildren() (for example network or database based) may * check during createChildren() if deferredDelete() returns true and return from * createChildren() immediately because result will be useless. */ bool deferredDelete(); public slots: // Populate children using children vector created by createChildren() virtual void populate(); /** Remove children recursively and set as not populated. This is used when refreshing collapsed items. */ virtual void depopulate(); virtual void refresh(); void emitBeginInsertItems( QgsDataItem* parent, int first, int last ); void emitEndInsertItems(); void emitBeginRemoveItems( QgsDataItem* parent, int first, int last ); void emitEndRemoveItems(); void emitDataChanged( QgsDataItem* item ); void emitDataChanged( ); void emitStateChanged( QgsDataItem* item, QgsDataItem::State oldState ); virtual void childrenCreated(); signals: void beginInsertItems( QgsDataItem* parent, int first, int last ); void endInsertItems(); void beginRemoveItems( QgsDataItem* parent, int first, int last ); void endRemoveItems(); void dataChanged( QgsDataItem * item ); void stateChanged( QgsDataItem * item, QgsDataItem::State oldState ); }; QFlags operator|(QgsDataItem::Capability f1, QFlags f2); /** Item that represents a layer that can be opened with one of the providers */ class QgsLayerItem : QgsDataItem { %TypeHeaderCode #include %End public: enum LayerType { NoType, Vector, Raster, Point, Line, Polygon, TableLayer, Database, Table, Plugin //!< added in 2.10 }; QgsLayerItem( QgsDataItem* parent, const QString& name, const QString& path, const QString& uri, LayerType layerType, const QString& providerKey ); // --- reimplemented from QgsDataItem --- virtual bool equal( const QgsDataItem *other ); // --- New virtual methods for layer item derived classes --- // Returns QgsMapLayer::LayerType QgsMapLayer::LayerType mapLayerType(); // Returns layer uri or empty string if layer cannot be created QString uri(); // Returns provider key QString providerKey(); /** Returns the supported CRS * @note Added in 2.8 */ QStringList supportedCRS(); /** Returns the supported formats * @note Added in 2.8 */ QStringList supportedFormats(); public: static const QIcon &iconPoint(); static const QIcon &iconLine(); static const QIcon &iconPolygon(); static const QIcon &iconTable(); static const QIcon &iconRaster(); static const QIcon &iconDefault(); virtual QString layerName() const; }; /** A Collection: logical collection of layers or subcollections, e.g. GRASS location/mapset, database? wms source? */ class QgsDataCollectionItem : QgsDataItem { %TypeHeaderCode #include %End public: QgsDataCollectionItem( QgsDataItem* parent, const QString& name, const QString& path = QString::null ); ~QgsDataCollectionItem(); void addChild( QgsDataItem *item /Transfer/ ); static const QIcon &iconDir(); // shared icon: open/closed directory static const QIcon &iconDataCollection(); // default icon for data collection }; /** A directory: contains subdirectories and layers */ class QgsDirectoryItem : QgsDataCollectionItem { %TypeHeaderCode #include %End public: enum Column { Name, Size, Date, Permissions, Owner, Group, Type }; QgsDirectoryItem( QgsDataItem* parent, const QString& name, const QString& path ); ~QgsDirectoryItem(); virtual void setState( State state ); QVector createChildren(); QString dirPath() const; virtual bool equal( const QgsDataItem *other ); virtual QIcon icon(); virtual QWidget *paramWidget() /Factory/; /* static QVector mProviders; */ //! @note not available via python bindings // static QVector mLibraries; }; /** Data item that can be used to report problems (e.g. network error) */ class QgsErrorItem : QgsDataItem { %TypeHeaderCode #include %End public: QgsErrorItem( QgsDataItem* parent, const QString& error, const QString& path ); ~QgsErrorItem(); }; // --------- class QgsDirectoryParamWidget : QTreeWidget { %TypeHeaderCode #include %End public: QgsDirectoryParamWidget( const QString& path, QWidget* parent /TransferThis/ = NULL ); protected: void mousePressEvent( QMouseEvent* event ); public slots: void showHideColumn(); }; /** Contains various Favourites directories */ class QgsFavouritesItem : QgsDataCollectionItem { %TypeHeaderCode #include %End public: QgsFavouritesItem( QgsDataItem* parent, const QString& name, const QString& path = QString() ); ~QgsFavouritesItem(); QVector createChildren(); void addDirectory( const QString& favIcon ); void removeDirectory( QgsDirectoryItem *item ); static const QIcon &iconFavourites(); }; /** A zip file: contains layers, using GDAL/OGR VSIFILE mechanism */ class QgsZipItem : QgsDataCollectionItem { %TypeHeaderCode #include %End public: QgsZipItem( QgsDataItem* parent, const QString& name, const QString& path ); ~QgsZipItem(); QVector createChildren(); const QStringList & getZipFileList(); //! @note not available via python bindings // static QVector mDataItemPtr; static QStringList mProviderNames; static QString vsiPrefix( const QString& uri ); static QgsDataItem* itemFromPath( QgsDataItem* parent, QString path, QString name ) /Factory/; //! @note available in python as itemFromFilePath static QgsDataItem* itemFromPath( QgsDataItem* parent, const QString& filePath, const QString& name, const QString& path ) /Factory,PyName=itemFromFilePath/; static const QIcon &iconZip(); };