前言

• 本章介绍矢量图层线要素单一符号中简单线（Simple line）的使用
• 说明：文章中的示例代码均来自开源项目qgis_cpp_api_apps

简单线（Simple line）符号的使用

• 以river.shp为例，添加river图层，如下图
  

QGis中的使用

• 简单线（Simple line）最常用，在“Symbol layer type”中选择“Simple line”，此时图层的设置选项如图所示
  
• 可设置项包括：颜色（Color）、边框宽度（Stroke width）、偏移量（Offset）、边框样式（Stroke style）、连接样式（Join style）、端点样式（Cap style）等，设置后效果如下图
  

二次开发代码实现

• 类QgsSimpleLineSymbolLayer是简单线（Simple line），详情见文档，类图如下
  
• 代码实现设置图层符号有两种方法：构造函数和静态函数create
• 方法一：构造函数

1. 首先从图层获取渲染器并转换为单一符号渲染器，代码如下

    QgsFeatureRenderer * layerRenderer= layer->renderer();
    QgsSingleSymbolRenderer *singleSymbolRenderer = QgsSingleSymbolRenderer::convertFromRenderer(layerRenderer);

2. 调用构造函数

auto simpleLineSymbolLayer = new QgsSimpleLineSymbolLayer(QColor("black"));

3. 构建QgsLineSymbol并设置图层的渲染器为单一符号

    //多个Symbol Layer构成一个Symbol
    QgsSymbolLayerList layerList;
    layerList << simpleLineSymbolLayer;
    //构造QgsLineSymbol并设置renderer
    auto lineSymbol = new QgsLineSymbol(layerList);
    singleSymbolRenderer->setSymbol(lineSymbol);
    layer->setRenderer(singleSymbolRenderer);

• 方法二：静态函数create
  方法一中步骤1，3不变，步骤2中使用create()成员函数

    QVariantMap mp;
    mp["line_color"] = "black";
    auto simpleLineSymbolLayer = QgsSimpleLineSymbolLayer::create(mp);

• 完整测试代码如下

void MainWindow::lineSimplelineSlot()
{
    //添加一个线图层
    QgsVectorLayer* layer = addTestShape(QStringLiteral("maps/shapefile/rivers.shp"));
    //从图层获取渲染器
    QgsFeatureRenderer * layerRenderer= layer->renderer();
    QgsSingleSymbolRenderer *singleSymbolRenderer = QgsSingleSymbolRenderer::convertFromRenderer(layerRenderer);

    //构建QgsSimpleLineSymbolLayer
#if 0
    auto simpleLineSymbolLayer = new QgsSimpleLineSymbolLayer(QColor("black"));
#else
    QVariantMap mp;
    mp["line_color"] = "black";
    auto simpleLineSymbolLayer = QgsSimpleLineSymbolLayer::create(mp);
#endif
    //多个Symbol Layer构成一个Symbol
    QgsSymbolLayerList layerList;
    layerList << simpleLineSymbolLayer;
    //构造QgsLineSymbol并设置renderer
    auto lineSymbol = new QgsLineSymbol(layerList);
    singleSymbolRenderer->setSymbol(lineSymbol);
    layer->setRenderer(singleSymbolRenderer);
}

• 效果如下图
  
  

总结

• 介绍了矢量图层单一符号简单线的使用