InputDialog – вывести диалоговое окно для ввода значений
Contents
Синтаксис:
function InputDialog(
[optional] Labels: WideString;
[optional] DefaultValues: WideString;
[optional] Types: WideString;
[optional] FormCaption: WideString;
[optional] BeginOfPeriod: TDateTime;
[optional] EndOfPeriod: TDateTime;
[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 – дата начала действия справочника, вызываемого из диалога. В качестве значения параметра можно указать константу MIN_CURRENT_PERIOD_BEGIN_DATE – минимальная возможная дата начала периода; |
| • | EndOfPeriod – дата окончания действия справочника, вызываемого из диалога. В качестве значения параметра можно указать константу MAX_CURRENT_PERIOD_END_DATE – максимальная возможная дата начала периода; |
Примечание
Если параметры BeginOfPeriod или EndOfPeriod не указаны, при открытии справочника используются значения периода, указанные в компоненте Текущий период.
| • | Name – имя диалога; |
| • | NeedShowHelpButton – признак отображения кнопки Справка; |
| • | SaveValuesFlags – признак сохранения последних введенных пользователем значений для их последующего отображения в диалоговом окне. Возможные значения: Yes, No. Значение по умолчанию No. Значение признака указывается для каждого поля с помощью разделителя «|», например «Yes|No|Yes|Yes». Введенные пользователем значения сохраняются, если заполнен параметр CallID; |
| • | CallID – идентификатор, являющийся частью ключа, в разрезе которого сохраняются последние введенные пользователем значения. Ключ состоит из значений параметров Name и CallID. Если параметр Name не заполнен, вместо него используется строка, производная от значений параметров Labels, Types, FormCaption и NeedShowHelpButton. |
Возвращаемое значение:
Строка, состоящая из значений полей ввода, разделенных символом «|». Для полей типа «Справочник», связанных с несколькими справочниками, перед значением ставится префикс в формате «<Код типа справочника>:». Для полей типа «Справочник» с возможностью выбора нескольких записей значения разделяются символом «;».
При нажатии клавиши ESC или кнопки Cancel функция прекращает свое выполнение, работа интерпретатора прерывается.
Описание:
Функция осуществляет ввод одного или нескольких значений в диалоговом окне.
Текст в поле будет отображаться в виде символов «*», если:
| • | поле имеет строковый тип и наименование «Пароль»; |
| • | наименование поля имеет значение системной строки локализации PASSWORD_EDIT_CAPTION группы SYSRES_SBREFDSC. |
Русскоязычный аналог имени функции:
Ввод
Пример:
Dialog = InputDialog('Дата|Цена|Пользователи и группы'; '01.01.1999|23.88|ПОЛ:Г00010'; 'Date|Number:2|ReferenceM:ПОЛ#ГПЛ';;;;;;'Date|Number|Users#Groups')
/* Если оставить значения по умолчанию, в переменной Dialog
будет возвращена строка '01.01.1999|23.88'. Если очистить
значение поля "Цена", будет возвращено значение '01.01.1999|'.
| © Компания DIRECTUM, 2018 | Сообщество пользователей DIRECTUM |