Функция SHAppBarMessage (shellapi.h)
Отправляет в систему сообщение на панели приложений.
Синтаксис
UINT_PTR SHAppBarMessage(
[in] DWORD dwMessage,
[in, out] PAPPBARDATA pData
);
Параметры
[in] dwMessage
Тип: DWORD
Значение сообщения панели приложений для отправки. Этот параметр может принимать одно из указанных ниже значений.
ABM_NEW (0x00000000)
Регистрирует новую панель приложений и указывает идентификатор сообщения, который система должна использовать для отправки уведомлений на панель приложений.
ABM_REMOVE (0x00000001)
Отменяет регистрацию панели приложений, удаляя ее из внутреннего списка системы.
ABM_QUERYPOS (0x00000002)
Запрашивает размер и положение экрана для панели приложений.
ABM_SETPOS (0x00000003)
Задает размер и положение экрана панели приложений.
ABM_GETSTATE (0x00000004)
Извлекает состояния автоподбора и всегда поверх панели задач Windows.
ABM_GETTASKBARPOS (0x00000005)
Извлекает ограничивающий прямоугольник панели задач Windows. Обратите внимание, что это относится только к системной панели задач. Также могут присутствовать другие объекты, в частности панели инструментов, поставляемые со сторонним программным обеспечением. В результате некоторые области экрана, не охваченные панелью задач Windows, могут быть не видны пользователю. Чтобы получить область экрана, не охваченную как панелью задач, так и другими областями приложения ( рабочей областью, доступной для приложения), используйте функцию GetMonitorInfo .
ABM_ACTIVATE (0x00000006)
Уведомляет систему о активации или деактивации панели приложений. Элемент lParamобъекта APPBARDATA , на который указывает pData, имеет значение TRUE для активации или FALSE для деактивации.
ABM_GETAUTOHIDEBAR (0x00000007)
Извлекает дескриптор на панель приложений с автоматическим отображением, связанную с определенным краем экрана.
ABM_SETAUTOHIDEBAR (0x00000008)
Регистрирует или отменяет регистрацию панели приложений с автоматическим отображением края экрана.
ABM_WINDOWPOSCHANGED (0x00000009)
Уведомляет систему об изменении положения панели приложений.
ABM_SETSTATE (0x0000000A)
Windows XP и более поздних версий: Задает состояние автоподбора и атрибутов всегда на вершине панели приложений.
ABM_GETAUTOHIDEBAREX (0x0000000B)
Windows XP и более поздних версий: Извлекает дескриптор на панель приложений автоподбора, связанную с определенным краем определенного монитора.
ABM_SETAUTOHIDEBAREX (0x0000000C)
Windows XP и более поздних версий: Регистрирует или отменяет регистрацию панели приложений с автоматическим отображением для края определенного монитора.
[in, out] pData
Тип: PAPPBARDATA
Указатель на структуру APPBARDATA . Содержимое структуры при входе и выходе зависит от значения, заданного в параметре dwMessage . Подробные сведения см. на страницах отдельных сообщений.
Возвращаемое значение
Тип: UINT_PTR
Эта функция возвращает зависимое от сообщения значение. Дополнительные сведения см. в документации по Windows SDK для конкретного отправленного сообщения на панели приложения. Ссылки на эти документы приведены в разделе См. также.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | shellapi.h |
| Библиотека | Shell32.lib |
| DLL | Shell32.dll (версия 4.0 или более поздняя) |
| Набор API | ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240) |