Edit

ABM_GETSTATE message

  • Article

Retrieves the autohide and always-on-top states of the Windows taskbar.

uState = (UINT) SHAppBarMessage(ABM_GETSTATE, pabd);

Parameters

pabd

Pointer to an APPBARDATA structure. You must specify the cbSize member when sending this message; all other members are ignored.

Return value

Returns zero if the taskbar is neither in the autohide nor always-on-top state. Otherwise, the return value is one or both of the following:

Return code Description
ABS_ALWAYSONTOP
 The taskbar is in the always-on-top state.
[!Note]
As of Windows 7, ABS_ALWAYSONTOP is no longer returned because the taskbar is always in that state. Older code should be updated to ignore the absence of this value in not assume that return value to mean that the taskbar is not in the always-on-top state.
ABS_AUTOHIDE
 The taskbar is in the autohide state.

Requirements

Requirement Value
Minimum supported client
 Windows XP [desktop apps only]
Minimum supported server
 Windows 2000 Server [desktop apps only]
Header
Shellapi.h