Sends an appbar message to the system.
Syntax
UINT_PTR SHAppBarMessage(
DWORD dwMessage,
PAPPBARDATA pData
);
Parameters
- dwMessage
-
[in] Appbar message value to send. This parameter can be one of the following values.
ABM_NEW- 0x00000000. Registers a new appbar and specifies the message identifier that the system should use to send notification messages to the appbar.
ABM_REMOVE- 0x00000001. Unregisters an appbar, removing the bar from the system's internal list.
ABM_QUERYPOS- 0x00000002. Requests a size and screen position for an appbar.
ABM_SETPOS- 0x00000003. Sets the size and screen position of an appbar.
ABM_GETSTATE- 0x00000004. Retrieves the autohide and always-on-top states of the Windows taskbar.
ABM_GETTASKBARPOS- 0x00000005. Retrieves the bounding rectangle of the Windows taskbar.
ABM_ACTIVATE- 0x00000006. Notifies the system to activate or deactivate an appbar. The lParam member of the APPBARDATA pointed to by pData is set to TRUE to activate or FALSE to deactivate.
ABM_GETAUTOHIDEBAR- 0x00000007. Retrieves the handle to the autohide appbar associated with a particular edge of the screen.
ABM_SETAUTOHIDEBAR- 0x00000008. Registers or unregisters an autohide appbar for an edge of the screen.
ABM_WINDOWPOSCHANGED- 0x00000009. Notifies the system when an appbar's position has changed.
ABM_SETSTATE- 0x0000000A. Windows XP and later: Sets the state of the appbar's autohide and always-on-top attributes.
- pData
-
[in, out] The address of an APPBARDATA structure. The content of the structure on entry and on exit depends on the value set in the dwMessage parameter.
Return Value
This function returns a message-dependent value. For more information, see the Windows Software Development Kit (SDK) documentation for the specific appbar message sent. Links to those documents are given in the See Also section.
Function Information
| Minimum DLL Version | shell32.dll version 4.0 or later |
|---|
| Custom Implementation | No |
|---|
| Header | shellapi.h |
|---|
| Import library | shell32.lib |
|---|
| Minimum operating systems |
Windows NT 4.0, Windows 95 |
|---|
See Also
ABM_NEW,
ABM_REMOVE,
ABM_QUERYPOS,
ABM_SETPOS,
ABM_GETSTATE,
ABM_GETTASKBARPOS,
ABM_ACTIVATE,
ABM_GETAUTOHIDEBAR,
ABM_SETAUTOHIDEBAR,
ABM_WINDOWPOSCHANGED,
ABM_SETSTATE