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

Статья
08/26/2023

[Элемент 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, которая содержит заголовок диалогового окна или идентификатор ресурса, указывающий, где нужно получить заголовок. Если и этот параметр, и hWnd имеют значение NULL, заголовок не отображается. Если этот параметр указывает на загружаемый ресурс, сформированный с помощью макроса MAKEINTRESOURCE , он переопределяет hWnd в качестве заголовка.

[in] fuStyle

Тип: UINT

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

...

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

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

Тип: int

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

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

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

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shellapi.h
Библиотека	Shlwapi.lib
DLL	Shlwapi.dll

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

MAKEINTRESOURCE

Messagebox

Share via