Skip to content

Latest commit

 

History

History
206 lines (102 loc) · 5.68 KB

nf-shellapi-shappbarmessage.md

File metadata and controls

206 lines (102 loc) · 5.68 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name req.apiset
NF:shellapi.SHAppBarMessage
SHAppBarMessage function (shellapi.h)
Sends an appbar message to the system.
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
SHAppBarMessage
SHAppBarMessage function [Windows Shell]
_win32_SHAppBarMessage
shell.SHAppBarMessage
shellapi/SHAppBarMessage
shell\SHAppBarMessage.htm
shell
173d6eff-b33b-4d7d-bedd-5ebfb1e45954
12/05/2018
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, SHAppBarMessage, SHAppBarMessage function [Windows Shell], _win32_SHAppBarMessage, shell.SHAppBarMessage, shellapi/SHAppBarMessage
shellapi.h
Windows
Windows XP [desktop apps only]
Windows 2000 Server [desktop apps only]
Shell32.lib
Shell32.dll (version 4.0 or later)
Windows
19H1
SHAppBarMessage
shellapi/SHAppBarMessage
c++
APIRef
kbSyntax
DllExport
Shell32.dll
ext-ms-win-shell-shell32-l1-2-1.dll
Ext-MS-Win-Shell-Shell32-L1-2-2.dll
SHAppBarMessage
ext-ms-win-shell-shell32-l1-2-1 (introduced in Windows 10, version 10.0.10240)

SHAppBarMessage function

-description

Sends an appbar message to the system.

-parameters

-param dwMessage [in]

Type: DWORD

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. Note that this applies only to the system taskbar. Other objects, particularly toolbars supplied with third-party software, also can be present. As a result, some of the screen area not covered by the Windows taskbar might not be visible to the user. To retrieve the area of the screen not covered by both the taskbar and other app bars—the working area available to your application—, use the GetMonitorInfo function.

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.

ABM_GETAUTOHIDEBAREX (0x0000000B)

Windows XP and later: Retrieves the handle to the autohide appbar associated with a particular edge of a particular monitor.

ABM_SETAUTOHIDEBAREX (0x0000000C)

Windows XP and later: Registers or unregisters an autohide appbar for an edge of a particular monitor.

-param pData [in, out]

Type: PAPPBARDATA

A pointer to an APPBARDATA structure. The content of the structure on entry and on exit depends on the value set in the dwMessage parameter. See the individual message pages for specifics.

-returns

Type: UINT_PTR

This function returns a message-dependent value. For more information, see the Windows SDK documentation for the specific appbar message sent. Links to those documents are given in the See Also section.

-see-also

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