描述
ColorRamp 可用于访问工程中的可用色带。
讨论
要引用工程中的色带，可使用 ArcGISProject 类中的 listColorRamps 方法。色带一经引用，您即可将其分配到对于 GraduatedColorsRenderer、GraduatedSymbolsRenderer 和 UniqueValueRenderer 类可用的 colorRamp 属性。
属性
| 属性 | 说明 | 数据类型 |
| name (只读) | 获取与色带相关的名称。仅通过 ArcGISProject 对象中的 listColorRamps 方法引用色带时，有效值才可用。如果从渲染器或着色器返回 ColorRamp，则name 属性将返回一个空字符串，因为名称不会随渲染器或着色器保留。 | String |
代码示例
下列脚本可用于将 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')