settagstringlist

Функция установки метки строки по номеру строки в списке строк.

Синтаксис:

rez = gettagstringlist(s_id, indx, tag);

Аргументы:

s_id – идентификатор списка строк,

indx – номер строки, для которой устанавливается метка,

tag – устанавливаемая метка.

Описание:

setagtstringlist(s_id, indx, tag) – функция установки метки строки tag по номеру строки indx в списке строк с идентификатором s_id. Нумерация строк в списке начинается с нуля.

Результат:

rez – результат операции. Логическая переменная.

Пример:

var
s_01:string = "string1" + chr(10) + "string2",
s_02:string = "string3",
tag:integer = 1;        
//создание списка строк 
slist = createstringlist;
//загрузим строку s_01 в список
settextstringlist(slist, s_01);
//добавим строку s_02 с меткой 2 в список
i = addstringlist(slist, s_02, 2);       
//получим метку строки с номером 2 из списка строк
res = settagstringlist(slist, 2, tag);            
//уничтожим список                                
freeobject(slist);

В процессе выполнения примера при помощи функции createstringlist будет создан список строк с идентификатором slist. В список строк slist при помощи функции settextstringlist будет загружена строка, объявленная с разделителем «перевод строки», в результате чего переменная slist будет содержать идентификатор списка строк “”string1”“string2””. Далее, при помощи функции addstringlist в список строк с идентификатором slist будет загружена строка “string3” с меткой 2. Далее, при помощи функции settagstringlist в списке строк с идентификатором slist будет установлена метка строки 1 по номеру строки 2. В результате переменная slist будет содержать идентификатор списка строк “”string1”“string2””string3””, переменной res будет присвоено значение “Да” – положительный результат операции. Перед завершением примера список строк удаляется при помощи функции freeobject.