Функция ShellAboutA (shellapi.h)

Статья
11/20/2024

Отображает диалоговое окно ShellAbout.

Синтаксис

INT ShellAboutA(
  [in, optional] HWND   hWnd,
  [in]           LPCSTR szApp,
  [in, optional] LPCSTR szOtherStuff,
  [in, optional] HICON  hIcon
);

Параметры

[in, optional] hWnd

Тип: HWND

Дескриптор окна родительского окна. Этот параметр может быть NULL.

[in] szApp

Тип: LPCTSTR

Указатель на строку, завершающую значение NULL, содержащую текст, отображаемый в заголовке диалогового окна ShellAbout и в первой строке диалогового окна после текста "Майкрософт". Если текст содержит разделитель (#), разделяющий его на две части, функция отображает первую часть в строке заголовка и вторую часть первой строки после текста "Майкрософт".

Windows 2000, Windows XP, Windows Server 2003: если строка, на которую указывает этот параметр, содержит разделитель (#), строка должна быть записываемой.

Windows Vista, Windows Server 2008: эта строка не может превышать 200 символов в длину. Содержимое szApp больше не будет отображаться после "Майкрософт", если нет разделителя #, в этом случае часть после # полностью заменит первую строку.

[in, optional] szOtherStuff

Тип: LPCTSTR

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

[in, optional] hIcon

Тип: HICON

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

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

Тип: int

TRUE в случае успешного выполнения; в противном случае FALSE.

Замечания

Обратите внимание, что в диалоговом окне функции ShellAbout используется текст и значок по умолчанию, относящиеся к Windows.

Чтобы просмотреть пример диалогового окна ShellAbout, выберите о Windows в раскрывающемся списке справки в проводнике Windows.

Заметка

Заголовок shellapi.h определяет ShellAbout как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shellapi.h
библиотеки	Shell32.lib
DLL	Shell32.dll (версия 3.51 или более поздняя)
набор API	ext-ms-win-shell-shell32-l1-2-2 (представлено в Windows 10 версии 10.0.14393)

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