ColorRamp

摘要

ColorRamp 可用于访问工程中的可用色带。

说明

要引用工程中的色带，可使用 ArcGISProject 类中的 listColorRamps 方法。 色带一经引用，您即可将其分配到对于 GraduatedColorsRenderer、GraduatedSymbolsRenderer、RasterStretchColorizer、UnclassedColorsRenderer 和 UniqueValueRenderer 类可用的 colorRamp 属性。

注：

可用色带列表取决于加载到工程中的样式。 要查看列表，建议打开目录视图，然后在内容窗格中展开 Styles 文件夹。 如果选择已安装的默认 ArcGIS 颜色样式，您将看到该样式包含超过 100 个配色方案。

属性

属性	说明	数据类型
name (只读)	获取与色带相关的名称。仅通过 ArcGISProject 对象中的 listColorRamps 方法引用色带时，有效值才可用。如果从渲染器或着色器返回 ColorRamp，则name 属性将返回一个空字符串，因为名称不会随渲染器或着色器保留。	String

代码示例

ColorRamp 示例

下列脚本可用于将 GraduatedColorsRenderer 的 colorRamp 属性更改成工程中所提供的名称为青色到紫色的色带。

import arcpy, os, sys

relpath = os.path.dirname(sys.argv[0])

p = arcpy.mp.ArcGISProject(relpath + r"\\GraduatedColors.aprx")
m = p.listMaps("Layers")[0]
l = m.listLayers("Natural*")[0]

sym = l.symbology
colorRamp = p.listColorRamps("Cyan to Purple")[0]
sym.renderer.colorRamp = colorRamp

l.symbology = sym

p.saveACopy(relpath + r'\\SavedOutput.aprx')