InputDialogEx – вывести диалоговое окно для ввода значений
Contents
Синтаксис:
function InputDialogEx(
[optional] Labels: WideString;
[optional] DefaultValues: WideString;
[optional] Types: WideString;
[optional] FormCaption: WideString;
[optional] BeginOfPeriod: TDateTime;
[optional] EndOfPeriod: TDateTime;
[optional] Mode: WideString;
[optional] Buttons: WideString;
[optional] DefaultButton: WideString;
[optional] CancelButton: WideString;
[optional] Name: WideString;
[optional] NeedShowHelpButton: WordBool = False;
[optional] SaveValuesFlags: WideString;
[optional] CallID: WideString);
Параметры:
| • | Labels – наименования полей для ввода. Если поставить символ «*» перед наименованием поля, оно будет обязательным для заполнения; |
| • | DefaultValues – начальные значения; |
| • | Types – типы вводимых значений. Возможные значения: |
| • | строка в формате «String:<Длина>»; |
| • | число в формате «Number:<Точность>»; |
| • | дата в формате «Date[:<Формат даты>]». Формат даты может принимать одно из значений: D: «Д.ММ.ГГ» (формат даты); T: «ЧЧ.ММ.СС Д.ММ.ГГ» (формат даты и времени). Значение по умолчанию D; |
| • | справочник в формате «Reference[M]:<Описание справочника 1>[#Описание справочника 2[…[#<Описание справочника N>]]]», где: |
| a) | [М] – признак возможности выбрать несколько записей указанных справочников; |
| b) | <Описание справочника> – <Имя типа справочника>[:<Код представления>[:<Параметры>[:<Проверка выбора>[:<Ведущий>]]]]; |
| c) | <Проверка выбора> – признак наличия ограничения на выбираемую запись. Возможные значения: Yes, No. Значение по умолчанию Yes; |
| d) | <Ведущий> – признак использования реквизита в качестве ведущего. Возможные значения: Yes, No. Значение по умолчанию Yes; |
| • | признак в формате «Pick:<Значение 1[,Значение 2[,Значение 3[:<Тип контроля>]]]>». <Тип контроля> может принимать одно из значений: C – выпадающий список; R – группа переключателей; B – флажок. Тип контроля «Флажок» можно использовать только для признака с двумя значениями. Если флажок установлен, то будет использоваться первое значение, если не установлен – второе. Значение по умолчанию C; |
| • | FormCaption – заголовок окна; |
| • | BeginOfPeriod – дата начала периода действия для справочника, вызываемого из диалога; |
| • | EndOfPeriod – дата окончания периода действия для справочника, вызываемого из диалога; |
Примечание
Если параметры BeginOfPeriod или EndOfPeriod не указаны, при открытии справочника будут использованы значения начала или конца текущего периода.
| • | Mode – режим вводимых значений. Если указано значение Просмотр или Browse, диалог работает в режиме просмотра, иначе в режиме редактирования; |
| • | Buttons – список кнопок. В качестве разделителя используется символ «|». Если параметр не заполнен, на форме будут отображаться кнопки OK и Cancel. При нажатии на любую кнопку, кроме кнопки, указанной в параметре CancelButton, проверяется заполнение обязательных реквизитов; |
| • | DefaultButton – кнопка по умолчанию; |
| • | CancelButton – кнопка для отмены по клавише ESC; |
| • | Name – имя диалога; |
| • | NeedShowHelpButton – признак отображения кнопки Справка; |
| • | SaveValuesFlags – признак сохранения последних введенных пользователем значений для их последующего отображения в диалоговом окне. Возможные значения: Yes, No. Значение по умолчанию No. Значение признака указывается для каждого поля с помощью разделителя «|», например «Yes|No|Yes|Yes». Введенные пользователем значения сохраняются, если заполнен параметр CallID; |
| • | CallID – идентификатор, являющийся частью ключа, в разрезе которого сохраняются последние введенные пользователем значения. Ключ состоит из значений параметров Name и CallID. Если параметр Name не заполнен, вместо него используется строка, производная от значений параметров Labels, Types, FormCaption, Buttons, DefaultButton, CancelButton и NeedShowHelpButton. |
Возвращаемое значение:
Строка, состоящая из значений полей ввода, разделенных символом «|», при этом последним значением возвращается нажатая кнопка.
Если параметр Buttons не заполнен, при подтверждении выбора в качестве последнего значения возвращается Сохранить, иначе – Отменить. Для полей типа «Справочник», связанных с несколькими справочниками, перед значением ставится префикс в формате «<Код типа справочника>:». Для полей типа «Справочник» с возможностью выбора нескольких записей значения разделяются символом «;».
Если была нажата кнопка ESC, параметр Buttons заполнен, а параметр CancelButton не заполнен, функция возвращает строку «НЕУДАЧА: ESC». Работа интерпретатора не прерывается при любом варианте завершения работы функции.
Описание:
Функция осуществляет ввод одного или нескольких значений в диалоговом окне.
Русскоязычный аналог имени функции:
ВводМеню
Пример:
Запрос периода и записи справочника «Работники» для построения отчета с сохранением последних введенных значений полей «Дата начала» и «Дата конца»:
!Value = InputDialogEx('Дата начала|Дата конца|Работник'; '01.06.2015|30.06.2015'; 'Date|Date|Reference:РАБ';;;;;;;;;; 'Yes|Yes'; 'EmployeeReport')
| © Компания DIRECTUM, 2018 | Сообщество пользователей DIRECTUM |