сообщение TDM_NAVIGATE_PAGE

Повторно создает диалоговое окно задачи с новым содержимым, имитируя функциональные возможности многостраничного мастера.

Параметры

wParam [in]

Не используется. Должен равняться нулю.

lParam [in]

Указатель на структуру TASKDIALOGCONFIG , описывающую создаваемый диалог задачи. Вызывающее приложение должно выделить эту структуру и задать ее члены. Значения элементов зависят от типа страницы, на который переходит пользователь.

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

Возвращаемое значение игнорируется.

Комментарии

Чтобы запустить диалоговое окно задачи мастера, используйте функцию TaskDialogIndirect . Когда пользователь переходит с помощью мастера, отправьте это сообщение в диалоговое окно задачи, чтобы отобразить следующую страницу. Создается новое диалоговое окно задачи (выглядит как новая страница) с элементами, указанными в структуре, на которую указывает lParam. При создании все содержимое диалогового окна уничтожается и восстанавливается. В результате все сведения о состоянии, хранящиеся в элементах управления (например, индикатор выполнения, кнопка развертывания или флажок проверки) в диалоговом окне, теряются.

Макет диалогового окна задачи может завершиться ошибкой, и это может не отражаться в возвращаемом значении. Возвращаемое значение S_OK отражает только то, что диалоговое окно задачи получило сообщение и попыталось его обработать. Если макет диалогового окна задачи завершается сбоем (не удается отобразить диалоговое окно задачи), диалоговое окно закроется и в зарегистрированной функции обратного вызова возвращается код HRESULT . Дополнительные сведения о синтаксисе функции обратного вызова см. в разделе TaskDialogCallbackProc.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Заголовок	Commctrl.h