DIALOG.Wait

Синтаксис

PROCEDURE Wait( [ Timeout: FLOAT ] );

Описание

Метод позволяет выполнить обработку событий диалога и его элементов управления. Если при обработке событий произошла ошибка, связанная с реализацией диалога или элемента управления, выбрасывается исключение 735.

Если диалог активен (см. DIALOG.Active), метод возвращает управление после обработки события, если оно возникло, или, если аргументом задан таймаут в секундах, по истечении таймаута. Если диалог неактивен, событие обрабатывается только в случае, если оно есть в очереди на момент вызова метода; ожидание не выполняется, аргумент игнорируется. Фактически в неактивном диалоге может возникнуть только событие DIALOG.OnSize.

Начиная с версии 14.160.040 для защиты от зависания ASL-кода по нажатию пользователем клавиши Esc на видимом экземпляре класса DIALOG выбрасывается исключение 301 класса Exc_TermByUser, если это разрешено для текущего режима TERM_BY_USER. Под отладчиком, как обычно, вместо выброса исключения выполняется останов. В результате код обработки событий подчиненного диалога стало нужно окружать TRY-блоком, обрабатывающим исключение 301, чтобы по нажатию Esc закрывался только верхний диалог, а не все диалоги сразу.

В версии 14.160.080 были приняты дополнительные меры.

• В реализацию метода DIALOG.Wait добавлен внутренний TRY-блок. Для диалога, подчиненного другому диалогу, а начиная с версии 14.263.010 и для диалога, содержащего кнопку отказа, исключение 301 класса Exc_TermByUser обрабатывается: при наличии кнопки отказа поведение соответствует нажатию на нее (начиная с версии 14.263.010), иначе поведение соответствует нажатию крестика в заголовке окна (см. DIALOG.OnClose). В остальных случаях указанное исключение пробрасывается.
• Если в момент нажатия Esc, которое могло бы быть обработано внутренним TRY-блоком в DIALOG.Wait этого диалога, поток исполнения не находится внутри DIALOG.Wait, выброс исключения 301 откладывается на 1.2 секунды. Если в течение 1.2 секунды поток исполнения ASL войдет в DIALOG.Wait, исключение будет выброшено внутри DIALOG.Wait. Если за 1.2 секунды поток исполнения ASL так и не вошел в DIALOG.Wait, исключение будет выброшено вне DIALOG.Wait, т.е. не будет обработано внутренним TRY-блоком в DIALOG.Wait.

Т.о. код обработки событий диалога с кнопкой отказа от редактирования и/или подчиненного диалога необязательно окружать TRY-блоком, перехватывающим исключение 301, если поток исполнения не покидает DIALOG.Wait на длительное время.

См. также

• свойство DIALOG.ProcessUserInput.