CDialog::OnCancel

virtual void OnCancel( );

Примечание

Функция OnCancel вызывается приложением при нажатии пользователем кнопки Отмена или клавиши <Esc> в модальном или немодальном диалоговом окне.

Перегрузка данной функции позволяет осуществить дополнительные операции при закрытии диалогового окна без сохранения внесённых в него изменений. По умолчанию данная функция вызывает функцию EndDialog, передавая ей в качестве аргумента значение IDCANCEL.

Если в немодальном диалоговом окне присутствует кнопка Отмена, соответствующий класс диалогового окна должен содержать перегруженную версию функции OnCancel в которой должна вызываться функция DestroyWindow. В ней не должен вызываться метод базового класса, поскольку в данном случае функция EndDialog делает диалоговое окно невидимым, но не уничтожает его.

CDialog::DoModal

virtual int DoModal( );

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

Целочисленное значение, соответствующее значению аргумента nResult функции CDialog::EndDialog, которая использовалась для закрытия данного диалогового окна. Возвращаемое значение может быть -1, если функции не удалось создать данное диалоговое окно, или IDABORT, если при его создании возникла какая-либо другая ошибка.

Примечание

Функция DoModal используется для отображения модального диалогового окна и возвращения результатов после его закрытия. Данная функция поддерживает интерфейс с пользователем при отображении диалогового окна. Она делает отрытое ею диалоговое окно модальным, то есть перехватывает все обращения пользователя к приложению и реагирует только на обращения к элементам управления данного диалогового окна. Все остальные обращения пользователя игнорируются, кроме немаскируемого прерывания, игнорируются.

Если пользователь нажимает в диалоговом окне кнопку OK или кнопку Cancel, то вызываются соответствующие им функции обработки сообщений OnOK или OnCancel, закрывающие данное диалоговое окно. По умолчанию функция OnOK обновляет содержимое переменных в объекте класса диалогового окна, проверяет их правильность и закрывает диалоговое окно, возвращая величину IDOK, а функция OnCancel закрывает диалоговое окно без обновления значений переменных в данном объекте и возвращает величину IDCANCEL. Пользователь может перегружать эти функции.

В настоящее время в стандартный процесс создания модального диалогового окна включена функция PreTranslateMessage.

CDialog::EndDialog

void EndDialog( int nResult );

Аргументы

0. nResult — содержит значение, возвращаемое функцией DoModal.

Примечание

Функция EndDialog вызывается для закрытия модального диалогового окна. При этом создавшая данный класс диалогового окна функция DoModal возвратит значение, содержащееся в аргументе nResult данной функции. Функция EndDialog вызывается для завершения процесса создания модального диалогового окна.

Данная функция может вызываться в любое время, даже из функции OnInitDialog, завершая процесс создания диалогового окна до его появления на экране и до передачи ему фокуса ввода.

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