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

Статья
11/20/2024

[ShellMessageBox доступен для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях.]

ShellMessageBox — это специальный экземпляр MessageBox, который предоставляет возможность использовать заголовок окна владельца в качестве заголовка поля сообщения.

Синтаксис

int ShellMessageBoxA(
  [in] HINSTANCE hAppInst,
  [in] HWND      hWnd,
  [in] LPCSTR    lpcText,
  [in] LPCSTR    lpcTitle,
  [in] UINT      fuStyle,
       ...       
);

Параметры

[in] hAppInst

Тип: HINSTANCE

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

[in] hWnd

Тип: HWND

Дескриптор окна владельца создаваемого окна сообщения. Если эта переменная не NULL, заголовок окна владельца используется в качестве заголовка поля сообщения.

[in] lpcText

Тип: LPCTSTR

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

[in] lpcTitle

Тип: LPCTSTR

Указатель на строку, завершающуюся значением NULL, которая содержит заголовок диалогового окна или идентификатор ресурса, указывающий место извлечения заголовка. Если этот параметр и hWndnull, заголовок не отображается. Если этот параметр указывает на загруженный ресурс, сформированный с помощью макроса MAKEINTRESOURCE, он переопределяет hWnd в качестве заголовка.

[in] fuStyle

Тип: UINT

Указывает содержимое и поведение диалогового окна. Возможные значения см. в разделе MessageBox.

...

Список аргументов переменной, объединенный с pszMsg для формирования полнотекстового текста, отображаемого в поле сообщения.

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

Тип: int

Целочисленное значение, указывающее кнопку, которая была нажата в окне сообщения. Дополнительные сведения см. в разделе MessageBox.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shellapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll

См. также

MAKEINTRESOURCE

MessageBox

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