SHAppBarMessage function
Applies to: desktop apps only
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.
Requirements
|
Minimum supported client | Windows XP |
|---|---|
|
Minimum supported server | Windows 2000 Server |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- ABM_NEW
- ABM_REMOVE
- ABM_QUERYPOS
- ABM_SETPOS
- ABM_GETSTATE
- ABM_GETTASKBARPOS
- ABM_ACTIVATE
- ABM_GETAUTOHIDEBAR
- ABM_SETAUTOHIDEBAR
- ABM_WINDOWPOSCHANGED
- ABM_SETSTATE
Send comments about this topic to Microsoft
Build date: 3/7/2012
The Taskbar
http://msdn.microsoft.com/en-us/library/cc144179(VS.85).aspx
Taskbar Display Options
The taskbar supports two display options: Auto-Hide and, in Windows Vista and earlier only, Always On Top (the taskbar is always in this mode in Windows 7 and later).
Please review this information carefully when working with the Taskbar and possible changes that have occured in Windows 7 and later versions.
- This isn't correct:
-
ABM_SETSTATE - 0x0000000A. Windows XP and later: Sets the state of the appbar's autohide and always-on-top attributes.
- 1/19/2010
- Task Se7en
