Метод IProgressDialog::SetCancelMsg (shlobj_core.h)
Задает сообщение, которое будет отображаться, если пользователь отменяет операцию.
Синтаксис
HRESULT SetCancelMsg(
[in] PCWSTR pwzCancelMsg,
LPCVOID pvResevered
);
Параметры
[in] pwzCancelMsg
Тип: PCWSTR
Указатель на строку Юникода, завершающуюся значением NULL, которая содержит отображаемое сообщение.
pvResevered
Тип: LPCVOID
Зарезервировано. Задайте значение NULL.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Несмотря на то, что пользователь нажимает кнопку Отмена, приложение не может немедленно вызвать IProgressDialog::StopProgressDialog , чтобы закрыть диалоговое окно. Приложение должно подождать до следующего вызова IProgressDialog::HasUserCancelled , чтобы обнаружить, что пользователь отменил операцию. Так как эта задержка может быть значительной, диалоговое окно хода выполнения предоставляет пользователю немедленную обратную связь, очищая текстовые строки 1 и 2 и отображая сообщение об отмене в строке 3. Сообщение предназначено для того, чтобы сообщить пользователю, что задержка является нормальной и что диалоговое окно хода выполнения будет закрыто в ближайшее время. Обычно для него задано значение типа "Пожалуйста, подождите, пока...".
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional, Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shlobj_core.h |
| DLL | Shell32.dll (версия 5.0 или более поздняя) |