QGis C++ 开发之图层分类显示

开发环境：Win10 + VS2010 + Qt 4.8.6 + QGis 2.14.4

简单介绍下如何用C++方式实现QGis中图层分类显示的方法。

要实现图层的分类显示主要会用到QgsCategorizedSymbolRendererV2类，这个类是一个简单的符号分类渲染器，该类是从QgsFeatureRendererV2继承而来，大家可以看下帮助文档中的截图：

QgsCategorizedSymbolRendererV2是其中一个子类，其他还有几个类似的子类，而这些子类的渲染方式就是对应的QGis中的几种不同的分类方式：

所以如果掌握了其中一种分类方式的用法，其他几种都是大同小异。下面要介绍的就是上图中的第3种方式，用法简单，但是也是平时用得最多的一种方式。

1、先说下如何简单的根据指定图层字段创建分类。先上一小段代码，再来慢慢说：

 	QgsCategoryList cats;
 	QgsFeature f;
 	QgsFeatureIterator it = mLayer->getFeatures();
 	while (it.nextFeature(f))

 		cats << QgsRendererCategoryV2(f.attribute("编号"),
 		unlinkedSymbolV2(), f.attribute("编号").toString());
 	}

 	mLayer->setRendererV2( new QgsCategorizedSymbolRendererV2("编号", cats) );

说明下mLyaer是准备处理的一个有效的QgsVectorLayer对象。

先看最后一句，通过图层的setRendererV2(QgsFeatureRendererV2*)便可以修改该图层的渲染方式，我们的目的就达到了，不过要详细说下传递的参数，要传递的参数就是上面提到的从QgsFeatureRendererV2继承而来的渲染器子类，我是直接通过两个参数来new了一个QgsCategorizedSymbolRendererV2对象：

第一个参数是图层中已有的字段名称，这里我使用矢量图层中叫”编号”的字段来进行分类；

第二个参数是一个QgsCategoryList对象，它其实是一个别名，本质上是QList<QgsRendererCategoryV2>，这个列表里保存的是与字段内容相对应的对象。QgsRendererCategoryV2是用于管理每个分类对象符号的类，通过一个图来看比较好理解，下图中显示了3种分类，每个分类就是一个单独的QgsRendererCategoryV2，它所显示的名称、颜色、符号等等都是通过QgsRendererCategoryV2来管理的。

接着看上面在while循环中我通过遍历图层中的要素，创建QgsRendererCategoryV2对象，并保存到List中，第一个参数是设置对象的值，直接返回图层中“编号”字段的值来填充；第三个参数是设置一个显示的标签，我直接就使用与第一个参数相同的值来设置；第二个参数是一个指向QgsSymbolV2的对象，该类主要用于管理符号,显示的颜色、符号、透明度这些就是通过这个参数来设置，这里我是同过一个单独的函数来返回这个对象，这个unlinkedSymbolV2()函数内容如下:

 QgsSymbolV2* unlinkedSymbolV2()
 {
 	QgsSymbolV2* mUnlinkedSymbolV2;

 	// 获得缺省的符号
 	mUnlinkedSymbolV2 = QgsSymbolV2::defaultSymbol(mLayer->geometryType());

 	// 设置透明度与颜色
 	mUnlinkedSymbolV2->setAlpha(0.5);
 	mUnlinkedSymbolV2->setColor(cUnlinked);

 	return mLinkedSymbolV2->clone();
 }
 

这个符号类提供一个静态defaultSymbol函数可返回一个默认的符号对象，传入一个几何类型以返回对应的几何类型符号，然后通过setAlpha及setColor修改下符号的透明度及颜色，最后返回一个符号类指针的副本。

这是处理前的截图：

这是处理后的截图：

2、最后再说下已经像上面分类好了，怎么进行更新。

  // 获得目前图层的分类样式符号渲染器
  QgsCategorizedSymbolRendererV2* cRenderer;
  cRenderer = dynamic_cast< QgsCategorizedSymbolRendererV2* >
  					( mLayer->rendererV2() );
  if (!cRenderer)
  {
  	return;
  }
  // 在渲染器中查找是否有对应的编号
  int index = cRenderer->categoryIndexForValue(QVariant(""));

  // 更新
   if (-1 != index)
  {
  	cRenderer->deleteCategory(index);
  	cRenderer->addCategory(QgsRendererCategoryV2
  		(QVariant(""), linkedSymbolV2(), ""));
  }

首先获得图层的渲染器类，如果之前图层没有进行过分类，将会得到一个空指针。

之前我们在构造QgsRendererCategoryV2对象时不是用“编号”字段的内容设置了它的值吗，现在就可以通过categoryIndexForValue函数来返回索引，找到正确的索引后先删除原来记录，再通过addCategory添加一个新的对象进去，这里我同样通过调用一个linkedSymbolV2()返回符号，和unlinkedSymbolV2()不同的地方就是颜色改变了，所以就不贴代码了。

更新完后还会有个小问题，会发现新添加的分类符号都显示在最后，显示顺序和之前不一样了，可以用下面这个方法按值重新排序。

 cRenderer->sortByValue();

关于图层分类显示基本上就这样了，其实涉及代码不多，应该还是好理解，其他几种分类渲染方式都大同小异。