mirror of
https://github.com/qgis/QGIS.git
synced 2025-10-30 00:07:09 -04:00
188 lines
5.4 KiB
Plaintext
188 lines
5.4 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/qgsrelationmanager.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
|
|
|
|
class QgsRelationManager : QObject
|
|
{
|
|
%Docstring(signature="appended")
|
|
This class manages a set of relations between layers.
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgsrelationmanager.h"
|
|
%End
|
|
public:
|
|
|
|
explicit QgsRelationManager( QgsProject *project = 0 );
|
|
%Docstring
|
|
Constructor for QgsRelationManager.
|
|
|
|
:param project: associated project (used to notify project of changes)
|
|
%End
|
|
|
|
QgsRelationContext context() const;
|
|
%Docstring
|
|
Gets the relation context
|
|
%End
|
|
|
|
void setRelations( const QList<QgsRelation> &relations );
|
|
%Docstring
|
|
Will set the specified relations and remove any relation currently set.
|
|
|
|
:param relations: A list of relations to set.
|
|
%End
|
|
|
|
QMap<QString, QgsRelation> relations() const;
|
|
%Docstring
|
|
Gets access to the relations managed by this class.
|
|
|
|
:return: A QMap where the key is the relation id, the value the relation object.
|
|
%End
|
|
|
|
void addRelation( const QgsRelation &relation );
|
|
%Docstring
|
|
Add a relation.
|
|
Invalid relations are added only if both referencing layer and referenced
|
|
layer exist.
|
|
|
|
:param relation: The relation to add.
|
|
%End
|
|
|
|
void removeRelation( const QString &id );
|
|
%Docstring
|
|
Remove a relation.
|
|
|
|
:param id: The id of the relation to remove.
|
|
%End
|
|
|
|
void removeRelation( const QgsRelation &relation );
|
|
%Docstring
|
|
Remove a relation.
|
|
|
|
:param relation: The relation to remove.
|
|
%End
|
|
|
|
QgsRelation relation( const QString &id ) const;
|
|
%Docstring
|
|
Gets access to a relation by its id.
|
|
|
|
:param id: The id to search for
|
|
|
|
:return: A relation. Invalid if not found.
|
|
|
|
.. seealso:: :py:func:`relationsByName`
|
|
%End
|
|
|
|
QList<QgsRelation> relationsByName( const QString &name ) const;
|
|
%Docstring
|
|
Returns a list of relations with matching names.
|
|
|
|
:param name: relation name to search for. Searching is case insensitive.
|
|
|
|
:return: a list of matching relations
|
|
|
|
.. seealso:: :py:func:`relation`
|
|
|
|
.. versionadded:: 2.16
|
|
%End
|
|
|
|
void clear();
|
|
%Docstring
|
|
Remove any relation managed by this class.
|
|
%End
|
|
|
|
QList<QgsRelation> referencingRelations( const QgsVectorLayer *layer = 0, int fieldIdx = -2 ) const;
|
|
%Docstring
|
|
Gets all relations where the specified layer (and field) is the referencing part (i.e. the child table with the foreign key).
|
|
|
|
:param layer: The layer which should be searched for.
|
|
:param fieldIdx: The field which should be part of the foreign key. If not set will return all relations.
|
|
|
|
:return: A list of relations matching the given layer and fieldIdx.
|
|
%End
|
|
|
|
QList<QgsRelation> referencedRelations( const QgsVectorLayer *layer = 0 ) const;
|
|
%Docstring
|
|
Gets all relations where this layer is the referenced part (i.e. the parent table with the primary key being referenced from another layer).
|
|
|
|
:param layer: The layer which should be searched for.
|
|
|
|
:return: A list of relations where the specified layer is the referenced part.
|
|
%End
|
|
|
|
static QList<QgsRelation> discoverRelations( const QList<QgsRelation> &existingRelations, const QList<QgsVectorLayer *> &layers );
|
|
%Docstring
|
|
Discover all the relations available from the current layers.
|
|
|
|
:param existingRelations: the existing relations to filter them out
|
|
:param layers: the current layers
|
|
|
|
:return: the list of discovered relations
|
|
|
|
.. versionadded:: 3.0
|
|
%End
|
|
|
|
QMap<QString, QgsPolymorphicRelation> polymorphicRelations() const;
|
|
%Docstring
|
|
Returns all the polymorphic relations
|
|
%End
|
|
|
|
QgsPolymorphicRelation polymorphicRelation( const QString &polymorphicRelationId ) const;
|
|
%Docstring
|
|
Returns the list of relations associated with a polymorphic relation
|
|
%End
|
|
|
|
void addPolymorphicRelation( const QgsPolymorphicRelation &polymorphicRelation );
|
|
%Docstring
|
|
Adds a new polymorphic relation. The generated relations are not available, they will be created automatically.
|
|
%End
|
|
|
|
void removePolymorphicRelation( const QString &polymorphicRelationId );
|
|
%Docstring
|
|
Removes an existing polymorphic relation and it's generated relations.
|
|
%End
|
|
|
|
void setPolymorphicRelations( const QList<QgsPolymorphicRelation> &relations );
|
|
%Docstring
|
|
Sets the specified polymorphic ``relations`` and removes any polymorphic relations currently set.
|
|
Will remove any generated relations and recreate them.
|
|
%End
|
|
|
|
signals:
|
|
void relationsLoaded();
|
|
%Docstring
|
|
Emitted when the relations were loaded after reading a project
|
|
%End
|
|
|
|
void changed();
|
|
%Docstring
|
|
Emitted when relations are added or removed to the manager.
|
|
|
|
.. versionadded:: 2.5
|
|
%End
|
|
|
|
public slots:
|
|
|
|
void updateRelationsStatus();
|
|
%Docstring
|
|
Updates relations status
|
|
%End
|
|
|
|
};
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/qgsrelationmanager.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|