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


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

Отображает диалоговое окно 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, выполните команду winver.exe.

Заметка

Заголовок 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)