Функция 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 для конкретного отправленного сообщения на панели приложения. Ссылки на эти документы приведены в разделе См. также.

Требования

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

ABM_ACTIVATE

ABM_GETAUTOHIDEBAR

ABM_GETAUTOHIDEBAREX

ABM_GETSTATE

ABM_GETTASKBARPOS

ABM_NEW

ABM_QUERYPOS

ABM_REMOVE

ABM_SETAUTOHIDEBAR

ABM_SETAUTOHIDEBAREX

ABM_SETPOS

ABM_SETSTATE

ABM_WINDOWPOSCHANGED