Список - Revision history

Admin: 1 revision imported

2023-04-25T09:34:23Z

1 revision imported

1>Admin: /* Атрибуты и функции */

2023-04-15T08:47:40Z

‎Атрибуты и функции

Admin: 1 revision imported

2021-11-20T17:10:00Z

1 revision imported

1>Admin at 06:53, 12 September 2021

2021-09-12T06:53:20Z

Admin: 1 revision imported

2021-02-07T06:55:31Z

1 revision imported

Admin at 11:23, 30 October 2020

2020-10-30T11:23:14Z

New page

{{infobox object
|image=list.png
|visual=[[Студия/Список значений|Список значений]], [[Студия/Поле со списком|Поле со списком]]
|object=List
|status=2
|create=[[List.Create|Create]]}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]}}
Объект '''список''' является универсальным массивом данных, позволяющим хранить как значения любого типа и их текстовые представления, так и иконки для каждого из значений и состояния флажков (для визуальных списков), соответствующих значениям. Списки имеют визуальные эквиваленты -- [[Студия/Список значений|Список значений]] и [[Студия/Поле со списком|Поле со списком]], используются как фильтры в запросах, отчетах и таблицах, позволяют проверить, содержится ли элемент справочника базы данных в выбранных папках этого справочника с учетом любых уровней вложения, используются для блокирования некоторого количества объектов БД (или семафоров) одновременно, обладают рядом других важных возможностей и функций.

Адресация элементов в списке происходит по их индексу (напр. ''Get'') или строковому представлению (напр. ''GetByName''). Иконки и флажки имеют значение только для визуальных списков, однако, могут использоваться и в программных.

== Атрибуты и функции==
{{function header}}
{{function entry
|name=[[List.Array|[<Индекс элемента (INT,STRING)>]]]
|form={{Grey|List}}'''[<Индекс или наименование элемента списка (INT,STRING)>]''':''<Значение>''
|type=0
|status=2
|visual=0
|description=Использование синтаксиса массивов позволяет получить или изменить значение элемента списка по его индексу (аргументом является число), либо наименованию (аргументом является строка).
}}
{{function entry
|name=[[List.Value|Value]]
|form={{Grey|List.}}'''Value''':''<Значение с индексом SelectedLine>''
|type=0
|status=2
|visual=1
|description=Получить значение списка с индексом SelectedLine
}}
{{function entry
|name=[[List.SelectedLine|SelectedLine]]
|form={{Grey|List.}}'''SelectedLine''':''<Выбранная строка (INT)>''
|type=0
|status=2
|visual=1
|description=Получить текущую (выбранную) строку визуального объекта (первая строка=1)
}}
{{function entry
|name=[[List.Create|Create]]
|form={{Grey|List.}}'''Create'''({{Optional|<Аргумент 1>,<Аргумент 2>...}}):''<Новый объект (LIST)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает новый объект типа [[Список]], заполняя его переданными аргументами, при их наличии
}}
{{function entry
|name=[[List.Add|Add]]
|form={{Grey|List.}}'''Add'''(''<Значение>''{{Optional|,<Строковое представление (STRING)>,<Индекс иконки (INT)>,<Сортировка (INT)>{{OptionalDefault|{{eq}}0}}}}):''<Позиция добавленного значения (INT)>''
|type=1
|status=2
|visual=0
|description=Функция добавляет к списку значение и присваивает ему строковое представление и иконку, сохраняя сортировку списка при необходимости
}}
{{function entry
|name=[[List.AddValue|AddValue]]
|form={{Grey|List.}}'''AddValue'''(''<Значение>''{{Optional|,<Строковое представление (STRING)>,<Индекс иконки (INT)>,<Сортировка (INT)>{{OptionalDefault|{{eq}}0}}}})
|type=1
|status=0
|visual=0
|description=Функция добавляет к списку значение с его строкововым представлением и иконкой, если оно отсутствовало, иначе список не изменяется.
}}
{{function entry
|name=[[List.UpdateValue|UpdateValue]]
|form={{Grey|List.}}'''UpdateValue'''(''<Значение>''{{Optional|,<Строковое представление (STRING)>,<Индекс иконки (INT)>,<Сортировка (INT)>{{OptionalDefault|{{eq}}0}}}}):''<Позиция добавленного или обновленного значения (INT)>''
|type=1
|status=0
|visual=0
|description=Функция добавляет к списку значение с его строкововым представлением и иконкой, если оно отсутствовало, либо обновляет его строковое представление и иконку, сохраняя сортировку списка при необходимости
}}
{{function entry
|name=[[List.Insert|Insert]]
|form={{Grey|List.}}'''Insert'''(''<Индекс (INT)>'',''<Значение>''{{Optional|,<Строковое представление (STRING)>,<Количество значений (INT)>}})
|type=1
|status=2
|visual=0
|description=Функция вставляет в список указанное количество одинаковых значений с указанным строковым представлением начиная с позиции, задаваемой индексом
}}
{{function entry
|name=[[List.Size|Size]]
|form={{Grey|List.}}'''Size'''({{Optional|<Новый размер списка (INT)>,<Значение инициализации>}}):''<Текущий размер списка (INT)>''
|type=1
|status=1
|visual=0
|description=Функция возвращает размер списка (количество значений в списке), изменяя размер при необходимости, заполняя новые элементы указанным значением или оставляя их пустыми, если значение не указано
}}
{{function entry
|name=[[List.Set|Set]]
|form={{Grey|List.}}'''Set'''(''<Индекс (INT)>'',''<Значение>''{{Optional|,<Строковое представление (STRING)>,<Количество значений (INT)>}})
|type=1
|status=2
|visual=0
|description=Функция заменяет в списке указанное количество значений на значение с указанным строковым представлением начиная с позиции, задаваемой индексом
}}
{{function entry
|name=[[List.SetByName|SetByName]]
|form={{Grey|List.}}'''SetByName'''(''<Строковое представление (STRING)>'',''<Значение>''{{Optional|,<Сортировка (INT)>{{OptionalDefault|{{eq}}0}},<Без учета регистра (INT)>{{OptionalDefault|{{eq}}1}}}})
|type=1
|status=2
|visual=0
|description=Функция заменяет в списке значение с указанным строковым представлением на указанное, либо добавляет значение, если представление отсутствует
}}
{{function entry
|name=[[List.SetName|SetName]]
|form={{Grey|List.}}'''SetName'''(''<Индекс (INT)>'',''<Строковое представление (STRING)>'')
|type=1
|status=2
|visual=0
|description=Функция устанавливает строковое представление значения списка с указанным индексом
}}
{{function entry
|name=[[List.GetByName|GetByName]]
|form={{Grey|List.}}'''GetByName'''(''<Строковое представление (STRING)>''{{Optional|,<Сортировка (INT)>{{OptionalDefault|{{eq}}0}},<Без учета регистра (INT)>{{OptionalDefault|{{eq}}1}}}}):''<Значение>''
|type=1
|status=2
|visual=0
|description=Функция возвращает значение списка с указанным строковым представлением, либо пустое значение, если представление отсутствует
}}
{{function entry
|name=[[List.Get|Get]]
|form={{Grey|List.}}'''Get'''(''<Индекс (INT)>''{{OptionalByRef|,<Переменная для строкового представления (STRING,OUT)>}}):''<Значение>''
|type=1
|status=2
|visual=0
|description=Функция возвращает значение списка по указанному индексу, также возвращает строковое представление значения, если второй параметр переменная
}}
{{function entry
|name=[[List.GetName|GetName]]
|form={{Grey|List.}}'''GetName'''(''<Индекс (INT)>''):''<Строковое представление (STRING)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает строковое представление значения списка по указанному индексу
}}
{{function entry
|name=[[List.Sort|Sort]]
|form={{Grey|List.}}'''Sort'''({{Optional|<Направление сортировки (INT)>{{OptionalDefault|{{eq}}0 (по неубыванию)}},<Способ сортировки (INT)>{{OptionalDefault|{{eq}}1 (объединением)}}}})
|type=1
|status=2
|visual=0
|description=Функция производит сортировку списка по значениям указанным способом в указанном направлении
}}
{{function entry
|name=[[List.SortByNames|SortByNames]]
|form={{Grey|List.}}'''SortByNames'''({{Optional|<Направление сортировки (INT)>{{OptionalDefault|{{eq}}0 (по неубыванию)}},<Способ сортировки (INT)>{{OptionalDefault|{{eq}}1 (объединением)}},<Без учета регистра (INT)>{{OptionalDefault|{{eq}}1}}}})
|type=1
|status=2
|visual=0
|description=Функция производит сортировку списка по строковым представлениям значений указанным способом в указанном направлении
}}
{{function entry
|name=[[List.Remove|Remove]]
|form={{Grey|List.}}'''Remove'''(''<Индекс (INT)>''{{Optional|,<Количество значений (INT)>{{OptionalDefault|{{eq}}1}}}})
|type=1
|status=2
|visual=0
|description=Функция удаляет из списка указанное количество значений начиная с позиции, задаваемой индексом
}}
{{function entry
|name=[[List.Clear|Clear]]
|form={{Grey|List.}}'''Clear'''()
|type=1
|status=2
|visual=0
|description=Функция удаляет из списка все значения
}}
{{function entry
|name=[[List.Check|Check]]
|form={{Grey|List.}}'''Check'''(''<Индекс (INT)>''{{Optional|,<Новый индекс галочки (INT)>}}):''<Текущий индекс галочки (INT)''
|type=1
|status=2
|visual=0
|description=Функция возвращает текущий индекс галочки значения списка с указанным индексом, затем изменяет индекс, если указан второй аргумент
}}
{{function entry
|name=[[List.ToString|ToString]]
|form={{Grey|List.}}'''ToString'''(''<Строка-разделитель (STRING)>''):''<Строка-результат (STRING)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает все значения списка в виде одной строки, значения будут разделены указанной строкой-разделителем
}}
{{function entry
|name=[[List.FromString|FromString]]
|form={{Grey|List.}}'''FromString'''(''<Исходная строка (STRING)>''{{Optional|,<Строка-разделитель (STRING)>}})
|type=1
|status=2
|visual=0
|description=Функция заполяет список значениями из указанной строки, значения должны быть разделены указанной строкой-разделителем
}}
{{function entry
|name=[[List.Copy|Copy]]
|form={{Grey|List.}}'''Copy'''():''<Новый объект списка (LIST)>''
|type=1
|status=2
|visual=0
|description=Функция создает новый список и заполняет его [[Объекты|копиями объектов]] старого
}}
{{function entry
|name=[[List.Find|Find]]
|form={{Grey|List.}}'''Find'''(''<Значение>''{{Optional|,<Начальный индекс поиска (INT)>,<Сортировка (INT)>{{OptionalDefault|{{eq}}0}}}}):''<Позиция найденного значения или ноль (INT)>''
|type=1
|status=2
|visual=0
|description=Функция производит поиск указанного значения в списке, начиная с определенной позиции (если указана), список может быть предвательно сортирован
}}
{{function entry
|name=[[List.FindByName|FindByName]]
|form={{Grey|List.}}'''FindByName'''(''<Строковое представление (STRING)>''{{Optional|,<Начальный индекс поиска (INT)>,<Сортировка (INT)>{{OptionalDefault|{{eq}}0}},<Без учета регистра (INT)>{{OptionalDefault|{{eq}}1}}}}):''<Позиция найденного значения или ноль (INT)>''
|type=1
|status=2
|visual=0
|description=Функция производит поиск указанного строкового представления в списке, начиная с определенной позиции (если указана), список может быть предвательно сортирован
}}
{{function entry
|name=[[List.Move|Move]]
|form={{Grey|List.}}'''Move'''(''<Индекс элемента (INT)>'',''<Количество позиций (INT)>'')
|type=1
|status=2
|visual=0
|description=Функция сдвигает значение внутри списка на указанное количество позиций
}}
{{function entry
|name=[[List.CopyTo|CopyTo]]
|form={{Grey|List.}}'''CopyTo'''({{ByRef|<Объект-результат (LIST,TAB)>}}{{Optional|,<Индекс первого элемента (INT)>,<Количество элементов для копирования (INT)>,<Имя столбца таблицы для копирования (STRING)>}})
|type=1
|status=2
|visual=0
|description=Функция копирует указанную часть списка в другой объект данных. Объект данных может иметь типы [[Список]] или [[Таблица]]
}}
{{function entry
|name=[[List.Group|Group]]
|form={{Grey|List.}}'''Group'''()
|type=1
|status=0
|visual=0
|description=Функция оставляет в списке только уникальные значения, удаляя дубликаты (даже если строковые представления их отличаются)
}}
{{function entry
|name=[[List.DataType|DataType]]
|form={{Grey|List.}}'''DataType'''({{Optional|''<Новый тип (STRING)>''}}):''<Текущий тип (STRING)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает тип данных значений списка, устанавливая новый, если задан (при этом текущие значения приводятся к новому типу)
}}
{{function entry
|name=[[List.JoinByNames|JoinByNames]]
|form={{Grey|List.}}'''JoinByNames'''(''<Список для копирования (LIST)>):''<Количество добавленных значений (INT)>''
|type=1
|status=0
|visual=0
|description=Копирует значения указанного списка в текущий только если их представления отсутствуют в исходном списке
}}
{{function entry
|name=[[List.Contains|Contains]]
|form={{Grey|List.}}'''Contains'''(''<Значение>''):''<0 или 1 (INT)>''
|type=1
|status=2
|visual=0
|description=Функция проверяет, является ли указанный элемент подмножеством списка (с учетом папок для объектов базы данных)
}}
{{function entry
|name=[[List.ClearContainsCache|ClearContainsCache]]
|form={{Grey|List.}}'''ClearContainsCache'''()
|type=1
|status=2
|visual=0
|description=Функция очищает сохраненные в буфере значения, используемые для ускорения функции Contains. Следующее обращение к функции Contains будет использовать данные базы данных (если необходимо)
}}
{{function entry
|name=[[List.Select|Select]]
|form={{Grey|List.}}'''Select'''({{OptionalByRef|''<Значение>''}}{{Optional|,<Режим выбора (INT,FORM)>{{OptionalDefault|{{eq}}см. описание}},<Заголовок окна выбора (STRING)>}}):''<Позиция выбранного значения или ноль (INT)>''
|type=1
|status=2
|visual=1
|description=Функция предлагает пользователю визуально выбрать элемент списка в указанном режиме (см. полное описание)
}}
{{function entry
|name=[[List.Icon|Icon]]
|form={{Grey|List.}}'''Icon'''(''<Индекс значения (INT)>''{{Optional|,<Новый индекс иконки (INT)>}}):''<Текущий индекс иконки (INT)>''
|type=1
|status=2
|visual=1
|description=Функция возвращает текущий индекс иконки значения, определяемого первым аргументом, затем изменяет иконку, если указан второй аргумент
}}
{{function entry
|name=[[List.BackgroundColor|BackgroundColor]]
|form={{Grey|List.}}'''BackgroundColor'''(''<Индекс значения (INT)>''{{Optional|,<Новый цвет фона (INT)>}}):''<Текущий цвет фона (INT)>''
|type=1
|status=0
|visual=1
|description=Функция возвращает текущий цвет заднего плана значения, определяемого первым аргументом, затем изменяет цвет, если указан второй аргумент
}}
{{function entry
|name=[[List.Font|Font]]
|form={{Grey|List.}}'''Font'''(''<Индекс значения (INT)>''{{Optional|,<Шрифт (STRING)>}}):''<Текущий шрифт (STRING)>''
|type=1
|status=0
|visual=1
|description=Функция возвращает текущий шрифт значения, определяемого первым аргументом, затем изменяет шрифт, если указан второй аргумент
}}
{{function entry
|name=[[List.Lock|Lock]]
|form={{Grey|List.}}'''Lock'''()
|type=1
|status=2
|visual=1
|description=Функция запрещает выполнения обновления визуального списка при любом его изменении до тех пор, пока не будет вызвана функция [[List.Unlock|Unlock]]. Функция может использоваться перед большим количеством обновлений или заполнении большого списка для получения значительного ускорения операции. Функцию необходимо использовать совместно с конструкцией <code>Try .. Finally</code> для исключения вероятности появления нерабочего списка на форме.
}}
{{function entry
|name=[[List.Unlock|Unlock]]
|form={{Grey|List.}}'''Unlock'''()
|type=1
|status=2
|visual=1
|description=Функция разрешает запрещенное ранее функцией [[List.Lock|Lock]] выполнения обновления визуального списка при любом его изменении. См. функцию [[List.Lock|Lock]].
}}
{{function entry
|name=[[List.IsLocked|IsLocked]]
|form={{Grey|List.}}'''IsLocked'''():''<Обновление запрещено (INT)>''
|type=1
|status=2
|visual=1
|description=Функция проверяет, запрещено ли в данный момент обновление списка при его изменении, которое инициируется с помощью функции [[List.Lock|Lock]].
}}
{{function footer}}

{{Объекты}}

← Older revision	Revision as of 09:34, 25 April 2023
(No difference)

@@ Line 273: / Line 273: @@
 {{function entry
 |name=[[List.Contains|Contains]]
-|form={{Grey|List.}}'''Contains'''(''<Значение>''):''<0 или 1 (INT)>''
+|form={{Grey|List.}}'''Contains'''(''<Значение>''{{Optional|,<Режим функции (INT)>{{Default|{{Eq}}0}}}}):''<0 или 1 (INT)>''
 |type=1
 |status=2

← Older revision	Revision as of 17:10, 20 November 2021
(No difference)

@@ Line 57: / Line 57: @@
 {{function entry
 |name=[[List.AddValue|AddValue]]
-|form={{Grey|List.}}'''AddValue'''(''<Значение>''{{Optional|,<Строковое представление (STRING)>,<Индекс иконки (INT)>,<Сортировка (INT)>{{OptionalDefault|{{eq}}0}}}})
+|form={{Grey|List.}}'''AddValue'''(''<Значение>''{{Optional|,<Строковое представление (STRING)>,<Индекс иконки (INT)>,<Сортировка (INT)>{{OptionalDefault|{{eq}}0}}}}):''<Позиция добавленного или найденного значения (INT)>''
 |type=1
-|status=0
+|status=2
 |visual=0
 |description=Функция добавляет к списку значение с его строкововым представлением и иконкой, если оно отсутствовало, иначе список не изменяется.
@@ Line 158: / Line 158: @@
 |visual=0
 |description=Функция удаляет из списка указанное количество значений начиная с позиции, задаваемой индексом
 }}
 {{function entry
@@ Line 235: / Line 243: @@
 |form={{Grey|List.}}'''Group'''()
 |type=1
-|status=0
+|status=2
 |visual=0
-|description=Функция оставляет в списке только уникальные значения, удаляя дубликаты (даже если строковые представления их отличаются)
+|description=Функция оставляет в списке только уникальные значения, удаляя дубликаты (даже если их строковые представления отличаются)
 }}
 {{function entry
@@ Line 248: / Line 256: @@
 }}
 {{function entry
-|name=[[List.JoinByNames|JoinByNames]]
+|name=[[List.Combine|Combine]]
-|form={{Grey|List.}}'''JoinByNames'''(''<Список для копирования (LIST)>):''<Количество добавленных значений (INT)>''
+|form={{Grey|List.}}'''Combine'''(''<Список для операции (LIST)>''{{Optional|,<Тип операции (STRING)>{{Default|{{Eq}}"ADD"}},<Список сортирован (INT)>{{Default|{{Eq}}0}}}})
 |type=1
 |status=0
 |visual=0
-|description=Копирует значения указанного списка в текущий только если их представления отсутствуют в исходном списке
+|description=Функция выполняет операцию, заданную вторым аргументом, над текущим списком и списком, заданным первым аргументом. Операция выполняется над представлениями значений. Результат сохраняется в текущем списке.
 }}
 {{function entry

← Older revision	Revision as of 06:55, 7 February 2021
(No difference)