QGis二次开发基础 -- 矢量图层的显示样式

带坐标的矢量图层作为GIS的核心数据，具有非常丰富的用途。人们往往喜欢在地图上做各种标记，不仅美观，而且使地图清晰，一目了然。于是应运而生了使用各种各样的图标作为地图标记的功能需求，在很多GIS软件上，这早已不是什么新鲜事了。然而在QGis二次开发的时候，同学们的对于图层样式自定义的需求貌似还挺大的，今天就来与大家探讨一下这个功能的实现。

下面我将会很简略的介绍这个功能相关的类，并用一个简单的例子来展示这些类的调用方式。当然，这里面还有很多功能可以供我们使用，但只要明白了调用机理，再去看 API 文档应该就没什么大问题了。

说明：文中所使用的 svg 格式图标来自于 QGis 源码工程的 image 文件夹，如下图所示

---

几个类之间的关系

首先要讲的，是矢量图层样式相关的几个类，它们分别是

• QgsVectorLayer
• QgsSymbolV2
• QgsSymbolLayerV2
• QgsFeatureRendererV2

它们的关系是这样的。QgsFeatureRendererV2 控制着QgsVectorLayer 的“渲染”样式，而具体用什么样式来“渲染”，则是有 QgsSymbolV2来定义的，QgsSymbolLayerV2 是 QgsSymbolV2 的扩展。搞明白这几个类的关系有助于我们后面的理解。实际上，我们基本不会直接用到这几个类，大多数时候是在用它们的子类。

QgsVectorLayer 不必多说，只需要知道使用它的方法“setRendererV2()”来绑定它的 Renderer 就好了。

QgsFeatureRendererV2

来看看矢量图层都支持那些 Renderer，也就是 QgsFeatureRendererV2 这个类的派生关系，如下图

从图上可以看到，这里支持的渲染方式还是蛮多的，GIS的同学看到这些名字应该不会太陌生，就是我们设置图层属性面板时候的那个下拉菜单里面的内容，见下图。

这里内容太多，就不逐个介绍了，本篇文章中我们只关注一个最简单也是最常用的 QgsSingleSymbolRendererV2 ，也就是我们经常使用在点图层标记上的单个的样式。

QgsSymbolV2

这个类就是直接关系到图层显示的“造型”了，也就是在这里设置各种图层样式的属性。还是先来看看它的派生类关系。

简单说明一下，QgsFillSymbolV2 对应的是多边形矢量图层，QgsLineSymbolV2 对应的是线性矢量图层， 而 QgsMarkerSymbolV2 自然就是对应点矢量图层了。

关于这些类的设置大多集中在“颜色”、“大小”、“透明度”等属性上，每个派生类也都有自己的一些属性，详细的情况还是建议大家看看 API 文档 。