10.3 QGIS多边形类型注释(Annotation)的应用与二次开发实现

前言

• 介绍注释(Annotation)图层在QGis中的使用以及二次开发的实现
• 说明：文章中的示例代码均来自开源项目qgis_cpp_api_apps

注释(Annotation)图层

表示包含一组地理参考注释的地图层，例如标记、直线、多边形或文本项。

QGis中的注释(Annotation)图层

• 首先创建一个Annotation图层，如下图所示
  
• 创建多边形类型注释，如下图
  

二次开发实现注释(Annotation)图层

Represents a map layer containing a set of georeferenced annotations, e.g.markers, lines, polygons or text items.
Annotation layers store a set of QgsAnnotationItem items, which are rendered according to the item’s z-order.

• 类QgsAnnotationLayer是注释层，详情见文档，类图如下
  
• 其成员函数QString addItem (QgsAnnotationItem *item)用于向图层添加项目
• QgsAnnotationItem是添加注释项目的基类，详情见文档，类图如下
  
• QgsAnnotationItem的几个基类，分别对应QGis中点、线、多边形和文本注释

多边形注释Item

An annotation item which renders a fill symbol for a polygon geometry.

• 类QgsAnnotationPolygonItem 为多边形注释Item，详情见文档类图如下
  
• 成员函数void setSymbol( QgsFillSymbol *symbol );可以设置其符号
• 构造函数需要传入QgsCurvePolygon *polygon类型的参数
• QgsCurvePolygon是多边形类，详情见文档，类图如下
  
• 这里使用的QgsCurvePolygon类，代表有外环和内环的多边形，关于QGis中几何图形的相关类后边会有详细介绍
• 完整测试代码如下

void MainWindow::annotationPolygonSlot()
{
    //添加注释图层
    QgsAnnotationLayer *annotationLayer = addTestAnnotationLayer();
    //定义3个点
    QgsPoint p1(20.33989,-33.86805);
    QgsPoint p2(20.47760,-33.86676);
    QgsPoint p3(20.39973,-33.80499);
    //3个点组成两条线
    QgsLineString *line1 = new QgsLineString(p1,p2);
    QgsLineString *line2 = new QgsLineString(p2,p3);
    //两条线添加到QgsCompoundCurve
    auto compoundCurve = new QgsCompoundCurve();
    compoundCurve->addCurve(line1);
    compoundCurve->addCurve(line2);
    compoundCurve->close();
    //创建多边形
    auto curvePolygon = new QgsCurvePolygon();
    curvePolygon->setExteriorRing(compoundCurve);
    //添加多边形item
    auto annotationPolygonItem = new QgsAnnotationPolygonItem(curvePolygon);
    annotationLayer->addItem(annotationPolygonItem);
}

• 效果如下图
  
  

总结

• 介绍了多边形类型注释(Annotation)的应用与二次开发实现