Admin: 1 revision imported

2021-02-07T06:51:43Z

1 revision imported

Admin at 09:15, 27 January 2020

2020-01-27T09:15:33Z

New page

{{infobox function
|name=Select
|object=[[Список]]
|caption=Визуальный выбор значения
|type=1
|status=2
|db=0
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Список]]}}
Функция предлагает пользователю визуально выбрать элемент списка в указанном режиме. В режимах выбора 1 и 2 элементы, имеющие значение "-" (строка), будут показаны как разделители. Элементы, являющиеся списками, будут показаны как подменю. Функция использует индексы иконок списка для отображения при выборе (0 -- иконка отсутствует).

== Синтаксис ==
<code>
{{Grey|List.}}'''Select'''({{OptionalByRef|''<Значение>''}}{{Optional|,<Режим выбора (INT,FORM)>{{OptionalDefault|{{eq}}см. описание}},<Заголовок окна выбора (STRING)>}}):''<Позиция выбранного значения или ноль (INT)>''
</code>
==== Аргументы ====
* <code>''<Значение>''</code> - {{optional}}{{byRef}} Переменная для получения значения, выбранного пользователем. Если значение не выбрано, переменная изменена не будет.
* <code>''<Режим выбора (INT)>''</code> - {{optional}} По умолчанию будет использован режим 1, если количество элементов в списке не достигает 16, иначе будет использован режим 0. Если указан, режим выбора принимает одно из возможных значений:
** '''0''' -- выбор с помощью окна со списком в нем.
** '''1''' -- выбор с помощью всплывающего меню, привязанному к визуальному элементу, имеющему фокус.
** '''2''' -- выбор с помощью всплывающего меню, выходящему рядом с последним нажатием клавиши мыши.
** '''Визуальный элемент формы''' (FORM) -- выбор с помощью всплывающего меню, привязанному к указанному визуальному элементу формы. Если элемент принадлежит форме, не активированной в данный момент, форма будет активирована до вывода всплывающего меню.
* <code>''<Заголовок окна выбора (STRING)>''</code> - {{optional}} Заголовок окна выбора, используемого в режиме 0.

==== Возвращаемое значение ====
Возвращает индекс выбранного элемента списка (начиная с 1) или ноль, если выбор не был произведен. Если выбор производится с учетом подменю, при успешном выборе, функция возвращает не число, а строку вида "<Позиция в первом списке>@<Позиция во втором списке>...".

== Примеры ==
<pre>
Знач:=0;
a:=List.Create("Пункт 1","Пункт 2","-","Пункт 3");
If a.Select(Знач,0,"Выберите пункт 2:")=0 Then
Message("Пользователь отказался сделать выбор!");
Exit;
EndIf;
Message("Пользователь выбрал: "+Знач);
//Добавляем второй список, как подпункт пункта 3.
a.Set(4,List.Create("Подпункт 3.1","Подпункт 3.2","Подпункт 3.3","Подпункт 3.4"),"Пункт 3");
Знач2:=a.Select(Знач,0,"Выберите пункт 3.4:");
If Знач2=0 Then
Message("Пользователь отказался сделать выбор!");
Exit;
EndIf;
Message("Пользователь выбрал путь: "+Знач2+", выбранное значение: "+Знач);
</pre>

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

List.Select - Revision history

Admin: 1 revision imported

Admin at 09:15, 27 January 2020