AskDate

From SunFlurry wiki
Revision as of 10:33, 9 June 2019 by Admin (talk | contribs) (Created page with "{{infobox function |name=AskDate |object=Функции общего назначения |caption=Визуальные функции |type=1 |status=2 |db=0 |exception=...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
  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;
...