getpropertyindex

Функция получения индекса свойства по имени

Синтаксис

ind = getpropertyindex(block_id, prop_name);

Аргументы

Имя Тип данных Описание
block_id integer Идентификатор блока
prop_name string Имя свойства объекта

Описание

getpropertyindex – функция выполняет получение индекса (номера) свойства с именем prop_name в списке свойств блока с идентификатором block_id. Идентификатор блока может быть получен, например, функциями getobj, createblock, findobjectbyfullname и другими.

Результат

Имя Тип данных Описание
ind integer Функция возвращает целое число, индекс заданного свойства в списке свойств блока, начиная с 1. Если свойство не найдено, то функция возвращает 0.

Пример

testblock = getobj(1);  // id блока
idx = getpropertyindex(testblock, "prop1");  // индекс существующего свойства
if idx >= 0 then deleteproperty(testblock, idx);  // удаление существующего свойства    
addproperty(testblock, -1,  0, "prop1", "property", "", 3);  // добавление нового свойства в конец списка

В результате выполнения данного скрипта происходит удаление свойства с заданным именем и создание нового в конце списка.

Дополнительные материалы

Нет.