SHAppBarMessage

Sends an appbar message to the system.

Syntax

UINT_PTR SHAppBarMessage(  __in     DWORD dwMessage,  __inout  PAPPBARDATA pData);

Parameters

dwMessage [in]

Type: DWORD

Appbar message value to send. This parameter can be one of the following values.

ABM_NEW (0x00000000): 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): 0x00000001. Unregisters an appbar, removing the bar from the system's internal list.
ABM_QUERYPOS (0x00000002): 0x00000002. Requests a size and screen position for an appbar.
ABM_SETPOS (0x00000003): 0x00000003. Sets the size and screen position of an appbar.
ABM_GETSTATE (0x00000004): 0x00000004. Retrieves the autohide and always-on-top states of the Windows taskbar.
ABM_GETTASKBARPOS (0x00000005): 0x00000005. Retrieves the bounding rectangle of the Windows taskbar.
ABM_ACTIVATE (0x00000006): 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): 0x00000007. Retrieves the handle to the autohide appbar associated with a particular edge of the screen.
ABM_SETAUTOHIDEBAR (0x00000008): 0x00000008. Registers or unregisters an autohide appbar for an edge of the screen.
ABM_WINDOWPOSCHANGED (0x00000009): 0x00000009. Notifies the system when an appbar's position has changed.
ABM_SETSTATE (0x0000000A): 0x0000000A. Windows XP and later: Sets the state of the appbar's autohide and always-on-top attributes.

pData [in, out]

Type: PAPPBARDATA

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

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.