esri_label_generate (AutoLISP)

Функция esri_label_generate создает надписи для выбранных объектов указанного векторного слоя с использованием значений заданного атрибутивного поля. Для смещения текста и изменения используемого по умолчанию размера текста есть дополнительные параметры текста. Можно связать значения атрибутивных полей объекта с большинством видов полей атрибутов объекта. Невозможно связать поля отчета с текстом или значениями атрибутов блока.

Синтаксис

(esri_label_generate flname field [label_properties])

Аргументы

• flname | строка | обязательный | имя существующего векторного веб-слоя чертежа.
• field | строка | обязательный | имя поля векторного слоя, связанного с надписью.
• label_properties | связанный список | дополнительный | Связанный список свойств полей векторного слоя в виде пар значений, разделенных точками, как задано в следующей таблице:

Связанная надпись	Тип значения	Описание значения	Обязательный/необязательный
"OFFSET"	Список из трех значений двойной точности	Список из трех значений двойной точности, который содержит расстояние смещения от стандартной точки подписи в направлении x, y и z.	дополнительно
"TEXTSIZE"	double	Размер текста создаваемых надписей	дополнительно

Пример использования

Сгенерируйте надписи для Owner поля векторного слоя Parcels, текст которых будет смещен на 10 единиц вверх и вправо от точки подписи по умолчанию с размером шрифта 7 единиц.

(esri_label_generate "Parcels" "Owner"
  (list
  (cons "OFFSET" '(10 10 0))
  (cons "TEXTSIZE" 7.0)
  )
)

Результат из примера использования

Создает текстовые элементы в виде связанных надписей и возвращает список значений true:

(T)

Возвращаемые значения

• В случае успеха функция возвращает список значений true: (T)
• В случае неудачи возвращается список с первым значением nil, а затем связанный список, содержащий значение ключа "Error" и соответствующее сообщение об ошибке в виде строки: (nil ("Error" . "<message>"))

Не удалось возвратить значения

Неудачное возвращение значения может произойти по любой из следующих причин:

• (nil ("Error" . "Feature layer not found."))

  Заданный векторный слой не найден.

• (nil ("Error" . "Field not found."))

  Исходный векторный слой field не существует на чертеже.

• (nil ("Error" . "Missing required argument."))

  Не указан один или несколько обязательных аргументов.