指定标注文本—ArcGIS Pro

标注文本字符串可从一个或多个要素属性中获得。标注是动态的，随要素属性值的变化而变化。当开启标注时，最初会基于单个字段来标注要素；例如，在气象地图上，使用日降雨量对气象站进行标注。此基于单个字段的标注在标注选项卡上进行设置。

注：

默认的标注字段为类型为字符串的第一个字段，并且其字段名中包含文本名称（不区分大小写）。如果任何字段的名称中均不包含该文本，则标注字段则默认为第一个类型为字符串类型的字段，然后默认为第一个类型为整数类型字段，最后默认为第一个类型为任意类型字段。

您可将多个属性字段添加到标注中。例如，您可同时使用日降雨量和最大风速对气象站进行标注。无论标注是基于单个属性字段还是多个属性字段，用于确定标注文本的语句均被称为标注表达式。每个标注类具有其自己的标注表达式。

了解有关创建标注表达式的详细信息

在标注表达式中，可插入您自己的文本，使它与标注一同显示在地图上。例如，在气象地图上，您可将缩写测量单位添加到每个标注中（例如，in 为英寸的缩写，MPH 为每小时英里数的缩写）。您还可在标注表达式中使用 Arcade、Python、VBScript 或 JScript 更改文本的显示方式。例如，可以插入一个函数，以使降雨量值显示在文本的某一行中，使风速值显示在第二行中。上面的两个示例都显示在下图中：

您可使用 ArcGIS Pro 文本格式化标签进一步控制文本在地图上的显示方式。通过文本格式化标签，您可以为标注文本的不同部分指定不同的文本显示属性。例如，您可使用斜体的蓝色文本显示降雨量值，使用常规的黑色文本显示风速值，如下图所示：

标注表达式

通过高级标注表达式，您能够将任何 Arcade、Python、VBScript 或 Jscript 逻辑添加到标注表达式中，包括条件逻辑和循环。例如，您可生成一种标注形式，标注中的每个单词仅第一个字母是大写，而不必考虑文本字符串在属性字段中的存储方式。您还可以通过 ArcGIS Pro 格式化标签，使用标注表达式来调整标注格式。这些是用来更改全部或部分标注外观的特殊字符。例如，您可能使用粗体格式化标签使第一行在一个堆叠的多行标注中显示为粗体。

提示：

Arcade 表达式可在整个 ArcGIS 中使用。标注配置文件用于标注表达式。 Arcade 表达式适用于 ArcGIS Pro 和 ArcGIS Maps SDKs for Native Apps，而其他表达式语言在其中可能不受支持。

标注表达式可以是简单的单行表达式，也可以是跨多个代码行并使用解析程序的程序设计逻辑的更为复杂的表达式。 Arcade 默认启用复杂表达式。当使用 Python、VBScript 或 JScript 时，必须选中高级复选框，并且必须将代码包含在函数中以启用多行表达式。

如果数据中包含编码值描述，则可以使用使用编码值描述选项在标注而非编码中显示这些描述。

字段值自动转换为文本字符串。因此，如果想要使用算术运算中的数值或进行比较时，必须将其转换回数值数据类型。

注：

NULL 值不会转换为文本字符串。它们将作为 NULL 传递到表达式。

使用 Arcade 时，字段值将保留其数据类型。

下面的实例添加了两个整型字段：

Arcade

$feature.FIELD1 + $feature.FIELD2

Python

int([FIELD1]) + int([FIELD2])

VBScript

cint([FIELD1]) + cint([FIELD2])

JScript

parseInt([FIELD1]) + parseInt([FIELD2])

其他 Maplex 标注引擎选项

Maplex Label Engine 提供了控制标注中使用的空白区这一附加功能。

使用移除多余空格选项可移除标注文本中的附加空格字符。这些额外空格包括所有前导空格、后导空格和内部空格字符。如果此选项不可用，这些空格将用于格式调整，例如，允许在堆叠标注中缩进文本。

使用移除多余换行符选项可移除标注文本中的附加换行符。如果此选项不可用，则可在堆叠标注中使用多行间距。

写入标注表达式

要写入标注表达式，请完成以下步骤：

确保按标注列出是显示内容窗格的活动方式。单击按标注列出选项卡。
在内容窗格中选择标注分类，然后单击标注选项卡。
在标注选项卡上的标注分类组中，单击表达式按钮。
从语言菜单中选择一种语言。
键入 Arcade、Python、VBScript 或 JScript 表达式。也可以创建一个表达式，方法是双击字段将其添加到表达式中，或选择该字段，右键单击并选择追加将该字段追加到单击的位置，并用空格隔开。双击所提供的文本函数将其添加到表达式。
使用 Python、VBScript 和 JScript 时，字段用方括号 [ ] 括起来，无需考虑图层数据源的数据类型。 Arcade 使用不同的方式指定字段。
字段语法
```
$feature.fieldname
```
连接字段语法
```
$feature['tablename.fieldname']
```
编码值属性域字段语法
```
DomainName($feature, 'fieldname')
```
提示：
使用 Arcade 时，可使用控制台函数帮助调试标注表达式。当您单击校验时，如果表达式中包含控制台函数，则会显示查看控制台消息链接。单击此链接以打开控制台消息窗口。使用 Arcade 时，还可以为表达式提供标题。
警告：
标注字段时，若字段名称包含特殊字符或以数字开头，则 Arcade 使用与连接字段语法相同的格式，例如，$feature['33field']、$feature['acres²']、$feature['st_area(SHAPE)']。

（可选）在表达式框中输入 ArcGIS Pro 文本格式化标签，将格式设置应用到一部分标注文本上。
注：
使用 Arcade 时，图层上的字段格式不会转移到标注中。必须使用 Arcade 格式化方法。

如果表达式要跨多个代码行，请选中高级复选框，然后输入标注表达式。当使用 Arcade 时，这不是必需的。
单击验证以确保没有语法错误，然后单击应用。
如果存在语法错误，则将在错误中引用行号和原因。要查看这些数字，请右键单击标注表达式输入框，然后选择显示行号。

可同时将常规和高级的标注表达式导出为标注表达式文件 (.lxp)，该文件可加载到其他图层或地图中。

表达式示例

以下是标注表达式示例：

将字符串串联到字段值上

将字符串串联到字段的值上；例如，以下表达式将创建一个标注，其中 PARCELNO 字段值的前面会加上文本 "Parcel no:"：

Arcade

"Parcel no: " + $feature.PARCELNO

Python

"Parcel no: " + [PARCELNO]

VBScript

"Parcel no: " & [PARCELNO]

JScript

"Parcel no: " + [PARCELNO]

对小数进行四舍五入

将小数四舍五入至设定的小数数位；例如，以下表达式可将 AREA 字段的值四舍五入为保留一个小数位：

Arcade

round(number($feature.AREA), 1)

Python

round(float([AREA]), 1)

VBScript

Round ([AREA], 1)

JScriptfunction FindLabel ( [AREA] )
{
var ss;
var num= parseFloat([AREA]);
ss =  num.toFixed(1);
  return (ss);
}

转换为大写和小写形式

将文本标注全部转换为大写形式或小写形式；例如，以下表达式可将 NAME 字段中的文本全部转换为小写形式：

Arcade

lower($feature.NAME)

Pythondef FindLabel ( [NAME] ):
  S = [NAME]
  S = S.lower()
  return S

VBScript

LCase ([NAME])

JScript

[NAME].toLowerCase()

转换为正确的大小写形式

将文本标注转换为正确的大小写形式；例如，以下表达式会处理以大写形式显示的 NAME 字段并将其转换为正确的大小写形式：

Arcade

Proper($feature.NAME, 'firstword')

Pythondef FindLabel ( [NAME] ):
  S = [NAME]
  S = S.title()
  return S

VBScriptFunction FindLabel ( [NAME] )
FindLabel = UCase(Left([NAME],1)) & LCase(Right([NAME], Len([NAME]) -1))
End Function

JScriptfunction FindLabel ( [NAME] )
{
var str = [NAME];
var iLen = String(str).length;
var upper = (str.substring(0,1)).toUpperCase();
var lower = (str.substring(1, iLen)).toLowerCase()
return upper + lower;
}

堆叠来自多个字段的文本

创建堆叠文本；例如，此表达式创建一个标注，其中 NAME 字段和 ADDRESS 字段位于不同的行上：

Arcade

$feature.NAME + TextFormatting.NewLine + $feature.ADDRESS

Python

[NAME] + '\n' + [ADDRESS]

VBScript

[NAME] & vbCrLf& [ADDRESS]

JScript

[NAME] + "\r" + [ADDRESS]

堆叠来自一个字段的文本

创建基于某字段文本的堆叠文本；例如，以下表达式用逗号来指定堆叠之处：

Arcade

replace($feature.LABELFIELD, ', ', '\n')

Pythondef FindLabel ( [LABELFIELD] ):
  S = [LABELFIELD]
  S = S.replace(', ', '\n')
  return S

VBScriptFunction FindLabel ( [LABELFIELD] )
FindLabel = replace([LABELFIELD], ", ", vbnewline)
End Function

JScriptfunction FindLabel ( [LABELFIELD] )
{
var r, re;
var str = [LABELFIELD];
re = /,/g;
r = str.replace(re, "\r");
return r;
}

格式化标注

格式化标注；例如，以下表达式将以货币格式显示标注：

Arcade

"Occupancy Revenue: $" + round($feature.MAXIMUM_OC * $feature.RATE, 2)

Pythondef FindLabel ( [MAXIMUM_OC], [RATE] ):
  import locale
  locale.setlocale(locale.LC_ALL, '')
  S = locale.currency(float([MAXIMUM_OC]) * float([RATE]))
  return S

VBScript

"Occupancy Revenue: " & FormatCurrency ([MAXIMUM_OC] * [RATE])

JScriptfunction FindLabel ( [MAXIMUM_OC], [RATE] )
{
var ss;
var num1 = parseFloat([MAXIMUM_OC]);
var num2 = parseFloat([RATE]);
var num3 = num1 * num2
ss =  num3.toFixed(2);
  return ("$" + ss);
}

带有部分字符串的标注

仅将部分字段用于标注；例如，该表达式显示第 3 个到第 5 个字符。

Arcade

mid($feature.LABELFIELD, 2, 3)

Pythondef FindLabel ( [LABELFIELD] ):
  S = [LABELFIELD]
  return S[2:5]

VBScript

Mid([LABELFIELD], 3, 3)

JScriptfunction FindLabel ( [LABELFIELD] )
{
var S;
var str = [LABELFIELD];
S = str.substring(2, 5);
return S;
}

创建 if-else 条件语句。

指定 if-else 条件语句。如果城市人口等于或超过 25 万，这些函数会用大的红色字体标注该城市名称；如果城市人口少于 25 万，则用默认标注字体标注该城市名称：

Arcadeif ($feature.POPULATION >=250000) {
    return "<CLR red='255'><FNT size = '14'>" + $feature.NAME + "</FNT></CLR>"
}
else {
    return $feature.NAME
}

Pythondef FindLabel ( [NAME], [POPULATION] ):
  if int([POPULATION]) >= 250000:
    return "<CLR red='255'><FNT size = '14'>" + [NAME] + "</FNT></CLR>"
  else:
    return [NAME]

VBScriptFunction FindLabel ([NAME], [POPULATION])
  if (cLng([POPULATION]) >= 250000) then
   FindLabel = "<CLR red='255'><FNT size = '14'>" + [NAME] + "</FNT></CLR>"
  else
	 FindLabel = [NAME]
  end if
End Function

JScriptfunction FindLabel ( [NAME], [POPULATION]  )
{
if (parseFloat([POPULATION]) >= 250000){
return ("<CLR red='255'><FNT size = '14'>" + [NAME] + "</FNT></CLR>");
}
else
return ([NAME]);
}

注：

要标注一个基于字段值的要素子集，请以在标注分类中创建 SQL 查询（而不是通过标注表达式）的方式进行。

其他资源

（一些信息并非存储在 Esri 所创建、拥有或维护的网页上。Esri 不能保证这些网页的可用性，也不对网页中的内容负责。）

有关此主题的反馈?

注：

标注表达式

提示：

注：

其他 Maplex 标注引擎 选项

写入标注表达式

提示：

警告：

注：

表达式示例

将字符串串联到字段值上

对小数进行四舍五入

转换为大写和小写形式

转换为正确的大小写形式

堆叠来自多个字段的文本

堆叠来自一个字段的文本

格式化标注

带有部分字符串的标注

创建 if-else 条件语句。

注：

其他资源

在本主题中

其他 Maplex 标注引擎选项