CreateInputDialog – создать диалог для ввода значений
Contents
Синтаксис:
function CreateInputDialog(
[optional] Labels: WideString;
[optional] DefaultValues: WideString;
[optional] Types: WideString;
[optional] FormCaption: WideString;
[optional] BeginOfPeriod: TDateTime;
[optional] EndOfPeriod: TDateTime;
[optional] Name: WideString;
[optional] NeedShowHelpButton: WordBool = True;
[optional] Names: WideString;
[optional] SaveValuesFlags: WideString;
[optional] CallID: WideString): IDialog;
Параметры:
| • | 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 не указаны, при открытии справочника будут использованы значения начала или конца текущего периода.
| • | Name – имя диалога; |
| • | NeedShowHelpButton – признак отображения кнопки Справка; |
| • | Names – имена реквизитов диалога. Значения указываются в формате [<Имя реквизита 1>[|<Имя реквизита 2>...[|<Имя реквизита N>]]]. Для разделения имен реквизитов справочников используется символ «|»; |
| • | SaveValuesFlags – признак сохранения последних введенных пользователем значений для их последующего отображения в диалоговом окне. Возможные значения: Yes, No. Значение по умолчанию No. Значение признака указывается для каждого поля с помощью разделителя «|», например «Yes|No|Yes|Yes». Введенные пользователем значения сохраняются, если заполнен параметр CallID; |
| • | CallID – идентификатор, являющийся частью ключа, в разрезе которого сохраняются последние введенные пользователем значения. Ключ состоит из значений параметров Name и CallID. Если параметр Name не заполнен, вместо него используется строка, производная от значений параметров Labels, Types, FormCaption, NeedShowHelpButton и Names. |
Возвращаемое значение:
Указатель на объект IDialog созданного диалога.
Описание:
Функция создает диалог для ввода одного или нескольких значений.
Для показа диалога необходимо вызвать метод Show.
Обратиться к элементами диалогового окна можно, начиная с индекса 1. Например, Dialog.Form.Controls.Values(1), Dialog.Form.Controls.Values(2) ... Dialog.Form.Controls.Values(N). При обращении к нулевому элементу диалог отобразится некорректно.
Подтверждение выбора значений осуществляется нажатием клавиши F2 или кнопки OK. При этом в свойстве Result формы диалога будет записано значение mrOk. При закрытии формы клавишей ESC или кнопкой Cancel в свойстве Result формы диалога будет записано значение mrCancel.
Доступ к полям диалога до и после показа формы может быть осуществлен через свойства DataSet и DetailDataSet диалога. В детальном разделе диалога хранятся значения полей типа «Справочник», для которых разрешен выбор нескольких записей. Поля остальных типов хранятся в основном наборе данных.
Если поле имеет строковый тип и наименование «Пароль», или если его наименование равно значению системной строки локализации PASSWORD_EDIT_CAPTION группы SYSRES_SBREFDSC, то текст в поле будет отображаться в виде символов «*».
Пример:
Запрос периода и записи справочника Работники для построения отчета с сохранением последних введенных значений полей Дата начала и Дата конца:
Dialog = CreateInputDialog('Дата начала|Дата конца|Работник'; '01.06.2015|30.06.2015'; 'Date|Date|Reference:РАБ';;;;;;; 'Yes|Yes'; 'EmployeeReport')
Dialog.Show
| © Компания DIRECTUM, 2018 | Сообщество пользователей DIRECTUM |