Функция ShellMessageBoxA (shellapi.h)
[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 |