getpropertyindex

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

Синтаксис:

ind = getpropertyindex(block_id, prop_name);

Аргументы:

block_id - идентификатор блока;

prop_name - строка, имя свойства.

Описание:

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

Результат:

Функция возвращает целое число, индекс заданного свойства в списке свойств блока, начиная с 1. Если свойство не найдено, то функция возвращает 0.

Пример:

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

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