qgslabelingresults.h

Go to the documentation of this file.

/***************************************************************************
  qgslabelingresults.h
  -------------------
   begin                : February 2021
   copyright            : (C) Nyall Dawson
   email                : nyall dot dawson at gmail dot com
 ***************************************************************************
 *                                                                         *
 *   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 QGSLABELINGRESULTS_H
#define QGSLABELINGRESULTS_H
 
#include <memory>
 
#include "qgis_core.h"
#include "qgis_sip.h"
#include "qgscalloutposition.h"
#include "qgslabelposition.h"
 
class QgsMapSettings;
class QgsLabelSearchTree;

class CORE_EXPORT QgsLabelingResults
{
  public:
    QgsLabelingResults();
    ~QgsLabelingResults();
 
    QgsLabelingResults( const QgsLabelingResults & ) = delete;
    QgsLabelingResults &operator=( const QgsLabelingResults &rh ) = delete;

    QList< QgsLabelPosition > allLabels() const;

    QList<QgsLabelPosition> labelsAtPosition( const QgsPointXY &p ) const;

    QList<QgsLabelPosition> labelsWithinRect( const QgsRectangle &r ) const;

    QList<QgsLabelPosition> groupedLabelPositions( long long groupId ) const;

    QList<QgsCalloutPosition> calloutsWithinRectangle( const QgsRectangle &rectangle ) const;

    void setMapSettings( const QgsMapSettings &settings );
 
  private:
#ifdef SIP_RUN
    QgsLabelingResults( const QgsLabelingResults & );
#endif
 
    std::unique_ptr< QgsLabelSearchTree > mLabelSearchTree;
 
    friend class QgsPalLabeling;
    friend class QgsVectorLayerLabelProvider;
    friend class QgsVectorLayerDiagramProvider;
};
 
#endif // QGSLABELINGRESULTS_H