Difference between revisions of "AskDate"

From SunFlurry wiki
Jump to: navigation, search
(Created page with "{{infobox function |name=AskDate |object=Функции общего назначения |caption=Визуальные функции |type=1 |status=2 |db=0 |exception=...")
 
m (1 revision imported)
 
(No difference)

Latest revision as of 08:43, 7 February 2021

  AskDate (Визуальные функции)
Объект:Функции общего назначения
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в дату, строку, число
Визуальность:Да

Функция выводит диалог в виде поля или календаря для выбора даты. В режиме поля, у пользователя есть возможность вызвать календарь. Функция возвращает результат выбора или ноль, если пользователь отказался от выбора.

Синтаксис

AskDate(<Дата по умолчанию (DATE)>,<Заголовок диалога (STRING)>,<Режим показа диалога (INT)>=0):<Выбранная дата или 0 (DATE,INT)>

Аргументы

  • <Дата по умолчанию (DATE)> - (необязательный аргумент) Дата по умолчанию, которую будет изменять пользователь
  • <Заголовок диалога (STRING)> - (необязательный аргумент) Заголовок диалога выбора даты
  • <Режим показа диалога (INT)> - (необязательный аргумент) Задает режим диалога, возможные значения:
    • 0 (по умолчанию) -- диалог выводится в виде всплывающего окна с календарем, привязанного к текущему элементу формы
    • 1 -- диалог выводится в виде модального окна с полем редактирования

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

Возвращает 0, если пользователь отказался от выбора, иначе возвращает выбранную дату.


Примеры

//Блок выбирает дату и запрещает продолжение обработки, если она больше текущей на неделю
Зн:=aEl.DocDate;
Зн:=AskDate(Зн,"Введите требуемую дату документа:",1);
If IsEmpty(Зн) Then
  Exit;
EndIf;
If Зн>Date()+7 Then
  Box("Запрещено выписывать документы на далекие будущие даты!",Q_STOP);
  Exit;
EndIf;
...