Функция ВЫБОР
Функция ВЫБОР выводит диалоговое окно, позволяющее выбрать строку из указанного списка.
ФУНКЦИЯ ТИП_ЧИСЛО: ВЫБОР(ТИП_СПИСОК: список
[, ТИП_СТРОКА: заголовок_окна
[, заголовок_колонки
[, ТИП_ЧИСЛО: ширина
[, номер
[, ТИП_ЛОГИКА редактирование
[, добавление
[, удаление
[, выбор_записи
]]]]
]]
]]
[; имя_доп_парам_1 = знач_доп_парам_1 [; имя_доп_парам_2 = знач_доп_парам_2 [; ... ]]]
)
Параметры
- список
- Объект типа список, содержимое строк которого будет выведено в диалоговом окне.
- заголовок_окна
- Заголовок диалогового окна. Если не указан, то отображается заголовок "Выбор из списка".
- заголовок_колонки
- Заголовок колонки. Если не указан, то отображается пустой заголовок.
- ширина
- Ширина строки в символах. Минимальное значение – 30. По умолчанию, либо при указании меньшего значения используется значение 30.
- номер
- Номер записи, на которую устанавливается курсор таблицы при вызове метода (по умолчанию 1).
- редактирование
- Разрешать ли редактирование значения записей списка по клавише F4 (см. Редактирование элементов). По умолчанию НЕТ.
- добавление
- Разрешать ли добавлять новые записи в список по клавише F7 (см. Добавление элемента). По умолчанию НЕТ.
- удаление
- Разрешать ли удаление записи из списка по клавише F8 (см. Удаление элемента). По умолчанию НЕТ.
- выбор_записи
- Указывает на необходимость открытия окна редактирования при выборе записи по клавише Enter (по умолчанию НЕТ).
- имя_доп_парам_n
- Имя n-го дополнительного параметра.
Внимание! Из соображений синтаксической однозначности дополнительные параметры отделяются от остальных параметров и между собой точкой с запятой, а не запятой.
Поддерживаются следующие параметры:- сообщение – текстовое сообщение, которое отображается над таблицей (строка);
- справка – ссылка на файл справки или команда Инфо-Навигатора (строка);
- кол_строк – количество видимых строк от 5 до 50, по умолчанию 10 (число).
- нач_действие – определяет действие при открытии окна: "add" - добавление строки, "edit" - редактирование тек. строки, "delete" - удаление тек. строки (строка);
- знач_доп_парам_n
- Значение n-го дополнительного параметра (выражение соответвтующего имени параметра типа).
Окно, вызываемое функцией ВЫБОР выглядит следующим образом:
Возвращаемое значение
При нажатии на кнопку ОК функция ВЫБОР возвращает номер выбранной записи. При нажатии на кнопку Отмена возвращает 0. Более точно определить была нажата кнопка ОК или Отмена позволяет вызоыв функции АТРИБУТ("результат_диалога").
Замечание: существует также ключевое слово ВЫБОР, используемое для многовариантной передачи управления в зависимости от значения заданного выражения.
Пример использования
СОЗДАТЬ(варианты, ТИП_СПИСОК)
варианты.ДОБАВИТЬ("Рубли")
варианты.ДОБАВИТЬ("Доллары")
варианты.ДОБАВИТЬ("Евро")
варианты.ДОБАВИТЬ("Франк")
варианты.ДОБАВИТЬ("Фунт")
варианты.ДОБАВИТЬ("Юань")
варианты.ДОБАВИТЬ("Рупия")
валюта = ВЫБОР(варианты, "Выберите валюту", "Валюта", 70, 3,
ДА, ДА, ДА, НЕТ)
