SHAppBarMessage

Sends an appbar message to the system.

Syntax

Copy

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.