Функция esri_label_get возвращает список, содержащий имя объекта текстовой надписи объекта, связанной с указанным полем атрибута объекта.
Синтаксис
(esri_label_get field ename)
Аргументы
- field| string | обязательный | Имя поля векторного слоя.
- ename | имя элемента AutoCAD | обязательный | Имя элемента связанного объекта AutoCAD.
Пример использования
Попытка получить имя элемента текстового элемента, который связан с полем Owner выбранного объекта.(setq text_EID (car (esri_label_get "Owner" (car (entsel)))))
Результат из примера использования
Возвращает только имя элемента из списка, содержащего имя элемента текстового элемента, связанного с полем Owner выбранного объекта:<Entity name: 1450e1b79f0>
Возвращаемые значения
Ниже перечислены возможные возвращаемые значения:
- В случае успеха функция возвращает список, содержащий имена элементов TEXT, MTEXT или ATTRIBUTE, связанных с указанным полем атрибута объекта.
- В случае ошибки возвращается список с первым значением nil, а затем возвращается связанный список, содержащий значение ключа "Error" и соответствующее сообщение об ошибке в виде строки: (nil ("Error" . "<message>")).
Не удалось возвратить значения
Неудачное возвращение значения может произойти по любой из следующих причин:
- nil
Указанное имя поля было некорректным или с другими ошибками.
- (nil ("Error" . "Missing required argument."))
Не указан один или несколько обязательных аргументов.
- (nil ("Error" . "No label found."))
Выбранный объект не находится в векторном слое.