APPBARDATA structure (shellapi.h)

Article
02/22/2024

Contains information about a system appbar message.

Syntax

typedef struct _AppBarData {
  DWORD  cbSize;
  HWND   hWnd;
  UINT   uCallbackMessage;
  UINT   uEdge;
  RECT   rc;
  LPARAM lParam;
} APPBARDATA, *PAPPBARDATA;

Members

cbSize

Type: DWORD

The size of the structure, in bytes.

hWnd

Type: HWND

The handle to the appbar window. Not all messages use this member. See the individual message page to see if you need to provide an hWind value.

uCallbackMessage

Type: UINT

An application-defined message identifier. The application uses the specified identifier for notification messages that it sends to the appbar identified by the hWnd member. This member is used when sending the ABM_NEW message.

uEdge

Type: UINT

A value that specifies an edge of the screen. This member is used when sending one of these messages:

This member can be one of the following values.

ABE_BOTTOM

Bottom edge.

ABE_LEFT

Left edge.

ABE_RIGHT

Right edge.

ABE_TOP

Top edge.

rc

Type: RECT

A RECT structure whose use varies depending on the message:

ABM_GETTASKBARPOS, ABM_QUERYPOS, ABM_SETPOS: The bounding rectangle, in screen coordinates, of an appbar or the Windows taskbar.
ABM_GETAUTOHIDEBAREX, ABM_SETAUTOHIDEBAREX: The monitor on which the operation is being performed. This information can be retrieved through the GetMonitorInfo function.

lParam

Type: LPARAM

A message-dependent value. This member is used with these messages:

See the individual message pages for details.

Requirements

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