Задание текста для надписей—ArcGIS Pro

Строки текста для надписей основываются на одном или нескольких атрибутивных полях пространственных объектов. Так как надписи динамические, при изменении атрибутивных значений текст надписи тоже автоматически изменится. Когда вы включаете надписывание, текст надписи создается на основании содержания одного поля. Например, на метеорологической карте вы можете подписать для каждой метеостанции суточное количество осадков или максимальную скорость ветра. Эта единственная надпись, основанная на поле, которая задается на вкладке Надписи.

Примечание:

По умолчанию в качестве поля надписи используется первое поле текстового типа с текстом «Name» в названии (в любом регистре). Если поля с таким текстом не существует, это будет первое поле текстового типа, затем первое целочисленное поле или первое поле любого типа.

Вы можете добавлять атрибутивные поля для своих надписей. Например, можно надписать для каждой метеостанции и количество осадков, и скорость ветра. Независимо от того, основаны ваши надписи на одном или нескольких полях, выражение, определяющее текст вашей надписи, называется Выражение надписи. Каждый класс надписей имеет свое собственное выражение.

Более подробно о построении выражений надписей

Вы можете вставлять ваш собственный текст в выражения надписей, чтобы они отображались на карте совместно с надписями. Например, на вашей карте погоды вы можете показать на каждой надписи единицы измерения (например, мм для количества осадков или м/сек для скорости ветра). Для изменения отображения текста в выражениях надписей можно также использовать 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 Label Engine

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);
}

Надписи с частью строки

Использование части поля для надписи; например, это выражение отображает символы с третьего по пятый:

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). Эти функции надписывают города большими красными буквами, если население больше 250 тыс. человек, или шрифтом по умолчанию – если меньше.

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 Label Engine

Написание выражения надписи

Подсказка:

Внимание:

Примечание:

Примеры выражений

Присоединение строки к значению поля

Округление десятичного числа

Конвертирование в верхний регистр и нижний регистр

Конвертация в нужный регистр

Создание многострочного текста из нескольких полей

Создание многострочного текста из одного поля

Форматирование надписей

Надписи с частью строки

Создание выражения условия if-else

Примечание:

Дополнительные ресурсы

В этом разделе