diff --git "a/docs/11-\350\241\250\350\276\276\345\274\217\357\274\214\350\277\207\346\273\244\345\222\214\350\256\241\347\256\227\345\200\274.md" "b/docs/11-\350\241\250\350\276\276\345\274\217\357\274\214\350\277\207\346\273\244\345\222\214\350\256\241\347\256\227\345\200\274.md" index 2e3a408..d8902d5 100644 --- "a/docs/11-\350\241\250\350\276\276\345\274\217\357\274\214\350\277\207\346\273\244\345\222\214\350\256\241\347\256\227\345\200\274.md" +++ "b/docs/11-\350\241\250\350\276\276\345\274\217\357\274\214\350\277\207\346\273\244\345\222\214\350\256\241\347\256\227\345\200\274.md" @@ -121,17 +121,17 @@ exp.evaluate(context) 下面是一个比较完整的例子，说明如何在矢量图层的上下文中使用表达式，以计算新的字段值： ```python -from qgis.PyQt.QtCore import QVariant +from qgis.PyQt.QtCore import QMetaType # 创建矢量图层 vl = QgsVectorLayer("Point", "Companies", "memory") pr = vl.dataProvider() -pr.addAttributes([QgsField("Name", QVariant.String), - QgsField("Employees", QVariant.Int), - QgsField("Revenue", QVariant.Double), - QgsField("Rev. per employee", QVariant.Double), - QgsField("Sum", QVariant.Double), - QgsField("Fun", QVariant.Double)]) +pr.addAttributes([QgsField("Name", QMetaType.Type.QString), + QgsField("Employees", QMetaType.Type.Int), + QgsField("Revenue", QMetaType.Type.Double), + QgsField("Rev. per employee", QMetaType.Type.Double), + QgsField("Sum", QMetaType.Type.Double), + QgsField("Fun", QMetaType.Type.Double)]) vl.updateFields() # 将数据添加到前三个字段 diff --git "a/docs/12-\350\257\273\345\217\226\345\222\214\345\255\230\345\202\250\350\256\276\347\275\256.md" "b/docs/12-\350\257\273\345\217\226\345\222\214\345\255\230\345\202\250\350\256\276\347\275\256.md" index 68b5e7a..07a12ac 100644 --- "a/docs/12-\350\257\273\345\217\226\345\222\214\345\255\230\345\202\250\350\256\276\347\275\256.md" +++ "b/docs/12-\350\257\273\345\217\226\345\222\214\345\255\230\345\202\250\350\256\276\347\275\256.md" @@ -41,7 +41,7 @@ from qgis.core import ( [`value()`](https://qgis.org/pyqgis/master/core/QgsSettings.html#qgis.core.QgsSettings.value)方法的第二个参数是可选的，如果没有，则返回默认值。 - 通过`global_settings.ini`文件在全局设置中预配置默认值，更多详情查看[Deploying QGIS within an organization](https://docs.qgis.org/testing/en/docs/user_manual/introduction/qgis_configuration.html#deploying-organization) + 通过`qgis_global_settings.ini`文件在全局设置中预配置默认值，更多详情查看[Deploying QGIS within an organization](https://docs.qgis.org/testing/en/docs/user_manual/introduction/qgis_configuration.html#deploying-organization) - **项目设置：** 在不同项目之间有所不同，因此它们与项目文件相关联。以地图画布背景颜色或目标坐标参考系统（CRS）作为例子——白色背景和WGS84可能适用于一个项目，而黄色背景和UTM投影适用于另一个项目。 diff --git "a/docs/14-\350\256\244\350\257\201\345\237\272\347\241\200.md" "b/docs/14-\350\256\244\350\257\201\345\237\272\347\241\200.md" index 3ace6f1..89860d1 100644 --- "a/docs/14-\350\256\244\350\257\201\345\237\272\347\241\200.md" +++ "b/docs/14-\350\256\244\350\257\201\345\237\272\347\241\200.md" @@ -136,7 +136,7 @@ assert (newAuthCfgId) [认证方法](https://docs.qgis.org/testing/en/docs/pyqgis_developer_cookbook/authentication.html#term-Authentication-Method)在认证管理器初始化时动态加载。可用的认证方法列表如下： 1. `Basic` 用户和密码验证 -2. `Esri-Token` ESRI token 基础认证 +2. `EsriToken` ESRI token 基础认证 3. `Identity-Cert` 身份证书认证 4. `PKI-Paths` PKI路径认证 5. `PKI-PKCS#12` PKI PKCS＃12认证 diff --git "a/docs/15-\344\273\273\345\212\241\342\200\224\342\200\224\345\234\250\345\220\216\345\217\260\345\201\232\347\271\201\351\207\215\347\232\204\345\267\245\344\275\234.md" "b/docs/15-\344\273\273\345\212\241\342\200\224\342\200\224\345\234\250\345\220\216\345\217\260\345\201\232\347\271\201\351\207\215\347\232\204\345\267\245\344\275\234.md" index 2fe4040..18de6ec 100644 --- "a/docs/15-\344\273\273\345\212\241\342\200\224\342\200\224\345\234\250\345\220\216\345\217\260\345\201\232\347\271\201\351\207\215\347\232\204\345\267\245\344\275\234.md" +++ "b/docs/15-\344\273\273\345\212\241\342\200\224\342\200\224\345\234\250\345\220\216\345\217\260\345\201\232\347\271\201\351\207\215\347\232\204\345\267\245\344\275\234.md" @@ -2,14 +2,15 @@ ```python from qgis.core import ( - QgsProcessingContext, - QgsTaskManager, - QgsTask, - QgsProcessingAlgRunnerTask, - Qgis, - QgsProcessingFeedback, - QgsApplication, - QgsMessageLog, + Qgis, + QgsApplication, + QgsMessageLog, + QgsProcessingAlgRunnerTask, + QgsProcessingContext, + QgsProcessingFeedback, + QgsProject, + QgsTask, + QgsTaskManager, ) ``` @@ -44,7 +45,7 @@ from qgis.core import ( pass task = QgsTask.fromFunction('heavy function', heavyFunction, - onfinished=workdone) + on_finished=workdone) ``` - 从处理算法创建任务 @@ -52,6 +53,7 @@ from qgis.core import ( ```python params = dict() context = QgsProcessingContext() + context.setProject(QgsProject.instance()) feedback = QgsProcessingFeedback() buffer_alg = QgsApplication.instance().processingRegistry().algorithmById('native:buffer') @@ -62,6 +64,11 @@ from qgis.core import ( 任何后台任务（无论如何创建）决不能使用任何主线程上的QObject，比如访问QgsVectorLayer, QgsProject或者执行任何GUI操作——比如创建新的部件或者与现有部件交互。只能从主线程访问或修改Qt控件。在任务启动之前，必须复制任务中使用的数据。试图从后台线程使用它们将导致崩溃。 + 此外，请始终确保并 [context](https://qgis.org/pyqgis/master/core/QgsProcessingContext.html#qgis.core.QgsProcessingContext) 和 [feedback](https://qgis.org/pyqgis/3.34/core/QgsProcessingFeedback.html#qgis.core.QgsProcessingFeedback) 至少与使用它们的任务一样长。如果在完成任务后，QGSTaskManager无法访问计划任务的上下文和反馈，则QGIS将崩溃。 + +!!! info + + 在调用 `QgsProcessingContext` 后不久调用 [setProject()](https://qgis.org/pyqgis/master/core/QgsProcessingContext.html#qgis.core.QgsProcessingContext.setProject) 是一种常见的模式。这允许任务及其回调函数使用大多数项目范围的设置。这在回调函数中使用空间图层时特别有价值。 可以使用[`QgsTask`](https://qgis.org/pyqgis/master/core/QgsTask.html#qgis.core.QgsTask)中的[`addSubTask()`](https://qgis.org/pyqgis/master/core/QgsTask.html#qgis.core.QgsTask.addSubTask) 函数来描述任务之间的依赖关系。当声明依赖关系时，任务管理器将自动确定如何执行这些依赖关系。只要有可能，依赖项将并行执行，以便尽快满足它们。如果取消了一个任务所依赖的任务，则相关任务也将被取消。循环依赖可能造成死锁，所以要小心。 diff --git "a/docs/16-\345\274\200\345\217\221Python\346\217\222\344\273\266.md" "b/docs/16-\345\274\200\345\217\221Python\346\217\222\344\273\266.md" index 34ffa79..352c272 100644 --- "a/docs/16-\345\274\200\345\217\221Python\346\217\222\344\273\266.md" +++ "b/docs/16-\345\274\200\345\217\221Python\346\217\222\344\273\266.md" @@ -98,7 +98,7 @@ category=Raster !!! 提示 - 如果qgisMaximumVersion为空，则在上传到[官方Python插件库](#1643)时，它将自动设置为主要版本加上.99（例如：3.99）。 + 如果qgisMaximumVersion为空，则在上传到[官方Python插件库](#1643-python)时，它将自动设置为主要版本加上.99（例如：3.99）。 metadata.txt示例： diff --git "a/docs/19-\347\275\221\347\273\234\345\210\206\346\236\220\345\272\223.md" "b/docs/19-\347\275\221\347\273\234\345\210\206\346\236\220\345\272\223.md" index 8ac488e..f42e3a8 100644 --- "a/docs/19-\347\275\221\347\273\234\345\210\206\346\236\220\345\272\223.md" +++ "b/docs/19-\347\275\221\347\273\234\345\210\206\346\236\220\345\272\223.md" @@ -272,6 +272,8 @@ from qgis.PyQt.QtGui import * vectorLayer = QgsVectorLayer('testdata/network.gpkg|layername=network_lines', 'lines') builder = QgsGraphBuilder(vectorLayer.sourceCrs()) director = QgsVectorLayerDirector(vectorLayer, -1, '', '', '', QgsVectorLayerDirector.DirectionBoth) +strategy = QgsNetworkDistanceStrategy() +director.addStrategy(strategy) startPoint = QgsPointXY(1179661.925139,5419188.074362) endPoint = QgsPointXY(1180942.970617,5420040.097560) diff --git "a/docs/2-\345\212\240\350\275\275\351\241\271\347\233\256.md" "b/docs/2-\345\212\240\350\275\275\351\241\271\347\233\256.md" index e06d483..8babb2c 100644 --- "a/docs/2-\345\212\240\350\275\275\351\241\271\347\233\256.md" +++ "b/docs/2-\345\212\240\350\275\275\351\241\271\347\233\256.md" @@ -117,7 +117,7 @@ QgsPathResolver.setPathWriter(my_processor) ```python readflags = Qgis.ProjectReadFlags() readflags |= Qgis.ProjectReadFlag.DontResolveLayers -project = QgsProject() +project = QgsProject().instance() project.read('C:/Users/ClintBarton/Documents/Projects/mysweetproject.qgs', readflags) ``` diff --git "a/docs/21-PyQGIS\351\200\237\346\237\245\350\241\250.md" "b/docs/21-PyQGIS\351\200\237\346\237\245\350\241\250.md" index 04b775c..12847a1 100644 --- "a/docs/21-PyQGIS\351\200\237\346\237\245\350\241\250.md" +++ "b/docs/21-PyQGIS\351\200\237\346\237\245\350\241\250.md" @@ -157,7 +157,7 @@ layer = QgsProject.instance().mapLayersByName("layer name you like")[0] # 5秒 layer.setAutoRefreshInterval(5000) # 自动刷新 -layer.setAutoRefreshEnabled(True) +layer.setAutoRefreshMode(Qgis.AutoRefreshMode.ReloadData) ``` **添加表单要素** @@ -264,7 +264,7 @@ from qgis.core import QgsVectorLayer, QgsFeature, QgsGeometry, QgsProject layer = QgsVectorLayer('Polygon?crs=epsg:4326', 'Mississippi', 'memory') pr = layer.dataProvider() poly = QgsFeature() -geom = QgsGeometry.fromWkt("POLYGON ((-88.82 34.99,-88.0934.89,-88.39 30.34,-89.57 30.18,-89.73 31,-91.63 30.99,-90.8732.37,-91.23 33.44,-90.93 34.23,-90.30 34.99,-88.82 34.99))") +geom = QgsGeometry.fromWkt("POLYGON ((-88.82 34.99,-88.09 34.89,-88.39 30.34,-89.57 30.18,-89.73 31,-91.63 30.99,-90.87 32.37,-91.23 33.44,-90.93 34.23,-90.30 34.99,-88.82 34.99))") poly.setGeometry(geom) pr.addFeatures([poly]) layer.updateExtents() diff --git "a/docs/4-\350\256\277\351\227\256\345\233\276\345\261\202\347\233\256\345\275\225\346\240\221.md" "b/docs/4-\350\256\277\351\227\256\345\233\276\345\261\202\347\233\256\345\275\225\346\240\221.md" index 1f318be..e34d6c4 100644 --- "a/docs/4-\350\256\277\351\227\256\345\233\276\345\261\202\347\233\256\345\275\225\346\240\221.md" +++ "b/docs/4-\350\256\277\351\227\256\345\233\276\345\261\202\347\233\256\345\275\225\346\240\221.md" @@ -127,7 +127,7 @@ print(checked_layers) QgsProject.instance().addMapLayer(layer1) ``` -你可以轻松地在[QgsVectorLayer](QgsVectorLayer)和[QgsLayerTreeLayer](https://qgis.org/pyqgis/master/core/QgsLayerTreeLayer.html#qgis.core.QgsLayerTreeLayer)之间切换： +你可以轻松地在[QgsVectorLayer](https://qgis.org/pyqgis/master/core/QgsVectorLayer.html#qgis.core.QgsVectorLayer)和[QgsLayerTreeLayer](https://qgis.org/pyqgis/master/core/QgsLayerTreeLayer.html#qgis.core.QgsLayerTreeLayer)之间切换： ```python node_layer = root.findLayer(country_layer.id()) diff --git "a/docs/6-\344\275\277\347\224\250\347\237\242\351\207\217\345\233\276\345\261\202.md" "b/docs/6-\344\275\277\347\224\250\347\237\242\351\207\217\345\233\276\345\261\202.md" index 0544584..086a8fc 100644 --- "a/docs/6-\344\275\277\347\224\250\347\237\242\351\207\217\345\233\276\345\261\202.md" +++ "b/docs/6-\344\275\277\347\224\250\347\237\242\351\207\217\345\233\276\345\261\202.md" @@ -364,7 +364,7 @@ if caps & QgsVectorDataProvider.ChangeGeometries: 这里有一些示例演示，如何使用这些编辑方法。 ```python -from qgis.PyQt.QtCore import QVariant +from qgis.PyQt.QtCore import QMetaType feat1 = feat2 = QgsFeature(layer.fields()) fid = 99 @@ -383,7 +383,7 @@ value ='My new name' layer.changeAttributeValue(fid, fieldIndex, value) # 添加新的字段 -layer.addAttribute(QgsField("mytext", QVariant.String)) +layer.addAttribute(QgsField("mytext", QMetaType.Type.QString)) # 删除字段 layer.deleteAttribute(fieldIndex) ``` @@ -424,12 +424,12 @@ with edit(layer): 添加字段（属性），你需要指定字段定义列表。删除字段，只需提供字段索引列表。 ```python -from qgis.PyQt.QtCore import QVariant +from qgis.PyQt.QtCore import QMetaType if caps & QgsVectorDataProvider.AddAttributes: res = layer.dataProvider().addAttributes( - [QgsField("mytext", QVariant.String), - QgsField("myint", QVariant.Int)]) + [QgsField("mytext", QMetaType.Type.QString), + QgsField("myint", QMetaType.Type.Int)]) if caps & QgsVectorDataProvider.DeleteAttributes: res = layer.dataProvider().deleteAttributes([0]) @@ -438,7 +438,9 @@ if caps & QgsVectorDataProvider.DeleteAttributes: ```python # 删除字段的备用方法 # 首先创建要删除的临时字段 (f1-3) -layer.dataProvider().addAttributes([QgsField("f1",QVariant.Int),QgsField("f2",QVariant.Int),QgsField("f3",QVariant.Int)]) +layer.dataProvider().addAttributes([QgsField("f1", QMetaType.Type.Int), + QgsField("f2", QMetaType.Type.Int), + QgsField("f3", QMetaType.Type.Int)]) layer.updateFields() count=layer.fields().count() # 图层字段个数 ind_list=list((count-3, count-2)) # 创建列表 @@ -616,7 +618,7 @@ class ESRIValueConverter(QgsVectorFileWriter.FieldValueConverter): def fieldDefinition(self, field): idx = self.layer.fields().indexFromName(field.name()) if idx == self.list_field_idx: - return QgsField(LIST_FIELD_NAME, QVariant.String) + return QgsField(LIST_FIELD_NAME, QMetaType.Type.QString) else: return self.layer.fields()[idx] @@ -634,12 +636,12 @@ opts.fieldValueConverter = converter ### 6.7.2 直接从要素创建 ```python -from qgis.PyQt.QtCore import QVariant +from qgis.PyQt.QtCore import QMetaType # 为要素属性定义字段。需要QgsFields对象 fields = QgsFields() -fields.append(QgsField("first", QVariant.Int)) -fields.append(QgsField("second", QVariant.String)) +fields.append(QgsField("first", QMetaType.Type.Int)) +fields.append(QgsField("second", QMetaType.Type.QString)) """ 创建一个矢量文件编写器的实例，它将创建矢量文件 @@ -716,7 +718,7 @@ URI还可以指定坐标参考系统、字段和索引。语法是： 以下示例代码说明了如何创建和填充内存提供者 ```python -from qgis.PyQt.QtCore import QVariant +from qgis.PyQt.QtCore import QMetaType # 创建图层 @@ -725,15 +727,15 @@ pr = vl.dataProvider() # 添加字段 -pr.addAttributes([QgsField("name", QVariant.String), - QgsField("age", QVariant.Int), - QgsField("size", QVariant.Double)]) +pr.addAttributes([QgsField("name", QMetaType.Type.QString), + QgsField("age", QMetaType.Type.Int), + QgsField("size", QMetaType.Type.Double)]) vl.updateFields() # 告诉矢量图层从提供者获取更改 # 添加一个要素 fet = QgsFeature() fet.setGeometry(QgsGeometry.fromPointXY(QgsPointXY(10,10))) -fet.setAttributes(["Johny", 2, 0.3]) +fet.setAttributes(["Johnny", 2, 0.3]) pr.addFeatures([fet]) # 在添加新要素时更新图层的范围，因为提供者中的范围更改不会传播到图层 @@ -847,25 +849,7 @@ layer.triggerRepaint() ```python print(layer.renderer().symbol().symbolLayers()[0].properties()) # Prints -{'angle': '0', -'cap_style': 'square', -'color': '0,128,0,255', -'horizontal_anchor_point': '1', -'joinstyle': 'bevel', -'name': 'circle', -'offset': '0,0', -'offset_map_unit_scale': '0,0', -'offset_unit': 'MM', -'outline_color': '0,0,0,255', -'outline_style': 'solid', -'outline_width': '0', -'outline_width_map_unit_scale': '0,0', -'outline_width_unit': 'MM', -'scale_method': 'area', -'size': '2', -'size_map_unit_scale': '0,0', -'size_unit': 'MM', -'vertical_anchor_point': '1'} +{'angle': '0', 'cap_style': 'square', 'color': '255,0,0,255,rgb:1,0,0,1', 'horizontal_anchor_point': '1', 'joinstyle': 'bevel', 'name': 'square', 'offset': '0,0', 'offset_map_unit_scale': '3x:0,0,0,0,0,0', 'offset_unit': 'MM', 'outline_color': '35,35,35,255,rgb:0.13725490196078433,0.13725490196078433,0.13725490196078433,1', 'outline_style': 'solid', 'outline_width': '0', 'outline_width_map_unit_scale': '3x:0,0,0,0,0,0', 'outline_width_unit': 'MM', 'scale_method': 'diameter', 'size': '2', 'size_map_unit_scale': '3x:0,0,0,0,0,0', 'size_unit': 'MM', 'vertical_anchor_point': '1'} ``` 如果要更改某些属性，这可能很有用： diff --git "a/docs/7-\345\207\240\344\275\225\345\244\204\347\220\206.md" "b/docs/7-\345\207\240\344\275\225\345\244\204\347\220\206.md" index d8714ff..ae8a802 100644 --- "a/docs/7-\345\207\240\344\275\225\345\244\204\347\220\206.md" +++ "b/docs/7-\345\207\240\344\275\225\345\244\204\347\220\206.md" @@ -230,7 +230,7 @@ for f in features: # Area (km2): 389267.8213816008 ``` -或者，你可能想知道两点之间的距离和方位。 +或者，你可能想知道两点之间的距离。 ```python d = QgsDistanceArea()