1С Предприятие 8.0. Описание встроенного языка

         

Функции для вызова диалога ввода данных


ВвестиДату (InputDate)

Синтаксис:

ВвестиДату(<Дата>, <Подсказка>, <Часть даты>)

Параметры:

<Дата>            Обязательный

Тип: Дата. Имя доступной в модуле переменной. В эту перемен­ную будет помещено введенное значение даты. Начальное значе­ние переменной будет использовано в качестве начального значе­ния в диалоге.

<Подсказка>            Необязательный

Тип: Строка. Текст заголовка окна диалога ввода даты. Может использоваться в качестве подсказки пользователю.

Значение по умолчанию: Пустая строка.

<Часть даты>             Необязательный

Тип: ЧастиДаты. Вводимая в диалоге часть (или части) даты. Значение по умолчанию: ДатаВремя.

При определении значения параметра используется системное перечисление ЧастиДаты (DateFractions) . Перечисление содержит следующие значения:

Время (Time)    -    Значение состоит только из времени (без даты). 



Дата (Date)    -    Значение состоит только из даты (без времени). 

ДатаВремя (DateTime)    -    Значение состоит из даты и времени.

Возвращаемое значение:

Тип: Булево. Истина - дата введена. Ложь - пользователь отказался от ввода даты.

Описание:

Вызывает диалог для ввода даты.

Пример:

ДатаНапоминания = РабочаяДата;

Подсказка = "Введите дату и время";

ЧастьДаты = ЧастиДаты.ДатаВремя;

Если ВвестиДату(ДатаНапоминания, Подсказка, ЧастьДаты) Тогда

    // запомнить дату напоминания

КонецЕсли ;

ВвестиЗначение (InputValue)

Синтаксис:

ВвестиЗначение(< Значение>, <Подсказка>, <Тмп>)

Параметры:

<3начение>            Обязательный

Тип: Произвольный. Имя доступной в модуле переменной. В эту переменную будет помещено введенное значение. Если параметр Тип не задан или имеет пустое значение, тип данной переменной используется в качестве типа вводимого в диалоге данного. Начальное значение переменной будет использовано в качестве начального значения в диалоге.




<Подсказка>            Необязательный

Тип: Строка. Текст заголовка окна диалога ввода значения. Может использоваться в качестве подсказки пользователю.

Значение по умолчанию: Пустая строка

<Тип>             Необязательный

Тип: Тип, ОписаниеТипов. Тип вводимого значения.

Значение по умолчанию: Если параметр не указан, используется тип параметра <3начение>

Возвращаемое значение:

Тип: Булево. Истина - в диалоге было введено значение, Ложь - пользователь отказался от ввода значения.

Описание:

Вызывает диалог для ввода значения заданного типа.

Пример:

ВыбЗнач = "" ;

М = Новый Массив;

М.Добавить(Тип("Число"));

М.Добавить(Тип("Строка"));

М.Добавить(Тип("Дата"));

КЧ = Новый КвалификаторыЧисла(12,2);

КС = Новый КвалификаторыСтроки(20);

КД = Новый КвалификаторыДаты(ЧастиДаты.Дата);

ОписаниеТипов = Новый ОписаниеТипов (М,КЧ, КС, КД);

Если ВвестиЗначение(ВыбЗнач, "Введите значение", ОписаниеТипов) Тогда 

    // обработка введенного значения

КонецЕсли;

ВвестиСтроку (InputString)

Синтаксис:

ВвестиСтроку(< Строка>, <Подсказка>, <Длина>, <Многострочность>}

Параметры:

<Строка>            Обязательный

Имя доступной в модуле переменной. В эту переменную будет помещена введенная в диалоге строка. Начальное значение пере­менной будет использовано в качестве начального значения в диалоге.

<Подсказка>            Необязательный

Тип: Строка. Текст заголовка окна диалога ввода строки. Может использоваться в качестве подсказки пользователю.

Значение по умолчанию: Пустая строка.

<Длина>                  Необязательный

Тип: Число. Длина вводимой строки.

Значение по умолчанию: Если параметр не указан или 0 - строка неограниченной длины.



<Многострочность>            Необязательный

Тип: Булево. Признак ввода многострочного текста: Истина -ввод многострочного текста с разделителями строк, Ложь -ввод простой строки.

Значение по умолчанию: Ложь.

Возвращаемое значение:

Тип: Булево. Истина - строка введена. Ложь - пользова­тель отказался от ввода строки.

Описание:

Вызывает диалог для ввода строки.

Пример:

Текст = ""; 

Подсказка = "Введите текст напоминания";

Если ВвестиСтроку (Текст,Подсказка, 0, истина) Тогда 

    // запомнить текст напоминания

КонецЕсли;

ВвестиЧисло (InputNumeric)

Синтаксис:

ВвестиЧисло(< Число, <Подсказка>, <Длина>, <Точность>)

Параметры:

< Число>            Обязательный

Тип: Число. Имя доступной в модуле переменной. В эту пере­менную будет помещено введенное число. Начальное значение переменной будет использовано в качестве начального значения в диалоге.

<Подсказка>            Необязательный

Тип: Строка. Текст заголовка окна диалога ввода числа. Может использоваться в качестве подсказки пользователю.

Значение по умолчанию: Пустая строка.

<Длина>            Необязательный

Тип: Число. Длина вводимого числа включая дробную часть (символы разделителей не учитываются).

Значение по умолчанию: 0. 

<Точность>            Необязательный

Тип: Число. Количество знаков в дробной части вводимого числа.

Значение по умолчанию: 0.

Возвращаемое значение:

Тип: Булево. Истина - число введено, Ложь - пользователь отказался от ввода.

Описание:

Вызывает диалог для ввода числа.

Пример:

КолВо = 1;

Если ВвестиЧисло(КолВо, "Введите количество", 10, 2) Tогда 

    // обработка введенного количество

КонецЕсли;

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»

Содержание раздела