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


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

Отображает сообщение в диалоговом окне хода выполнения.

Синтаксис

HRESULT SetLine(
       DWORD   dwLineNum,
  [in] PCWSTR  pwzString,
       BOOL    fCompactPath,
       LPCVOID pvResevered
);

Параметры

dwLineNum

Тип: DWORD

Номер строки, в которой должен отображаться текст. В настоящее время существует три строки: 1, 2 и 3. Если флаг PROGDLG_AUTOTIME был включен в параметр dwFlags при вызове метода IProgressDialog::StartProgressDialog , можно использовать только строки 1 и 2. Предполагаемое время будет отображаться в строке 3.

[in] pwzString

Тип: PCWSTR

Строка Юникода, завершающаяся нулевым значением, которая содержит текст.

fCompactPath

Тип: BOOL

Значение TRUE , чтобы строки пути были сжаты, если они слишком велики для размещения в строке. Пути сжимаются с помощью PathCompactPath.

pvResevered

Тип: LPCVOID

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

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

Тип: HRESULT

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

Комментарии

Эта функция обычно используется для отображения такого сообщения, как "Элемент XXX в настоящее время обрабатывается". Как правило, сообщения отображаются в строках 1 и 2, при этом строка 3 зарезервирована на предполагаемое время.

Требования

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

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

IProgressDialog