Метод IProgressDialog::StartProgressDialog (shlobj_core.h)

Статья
08/26/2023

Запускает диалоговое окно хода выполнения.

Синтаксис

HRESULT StartProgressDialog(
  [in] HWND     hwndParent,
       IUnknown *punkEnableModless,
       DWORD    dwFlags,
       LPCVOID  pvResevered
);

Параметры

[in] hwndParent

Тип: HWND

Дескриптор родительского окна диалогового окна.

punkEnableModless

Тип: IUnknown*

Зарезервировано. Задайте значение NULL.

dwFlags

Тип: DWORD

Флаги, управляющие операцией диалогового окна хода выполнения. Сочетание следующих значений:

PROGDLG_NORMAL

Обычное поведение диалогового окна хода выполнения.

PROGDLG_MODAL

Диалоговое окно хода выполнения будет модальным для окна, указанного hwndParent. По умолчанию диалоговое окно хода выполнения является немодовым.

PROGDLG_AUTOTIME

Автоматически оцените оставшееся время и отобразите оценку в строке 3. Если этот флаг установлен, IProgressDialog::SetLine можно использовать только для отображения текста в строках 1 и 2.

PROGDLG_NOTIME

Не показывать текст "оставшееся время".

PROGDLG_NOMINIMIZE

Не отображайте кнопку свернуть на панели подпись диалогового окна.

PROGDLG_NOPROGRESSBAR

Не отображать индикатор выполнения. Как правило, приложение может количественно определить, сколько осталось операций, и периодически передавать это значение в IProgressDialog::SetProgress. Диалоговое окно хода выполнения использует эти сведения для обновления индикатора выполнения. Этот флаг обычно устанавливается, когда вызывающее приложение должно ждать завершения операции, но не содержит количественных сведений, которые могут использоваться для обновления диалогового окна.

PROGDLG_MARQUEEPROGRESS

Windows Vista и более поздних версий. Устанавливает индикатор выполнения в режим шайби. Это приводит к прокрутке индикатора выполнения по горизонтали, аналогично отображению области. Используйте этот параметр, если вы хотите указать, что выполняется ход выполнения, но время, необходимое для выполнения операции, неизвестно.

PROGDLG_NOCANCEL

Windows Vista и более поздних версий. Кнопка отмены не отображается. Операцию нельзя отменить. Используйте этот параметр только при крайней необходимости.

pvResevered

Тип: LPCVOID

Зарезервировано. Задайте значение NULL.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h
DLL	Shell32.dll (версия 5.0 или более поздняя)

См. также раздел

IProgressDialog

Поделиться через