TITLEBARINFOEX structure (winuser.h)

Expands on the information described in the TITLEBARINFO structure by including the coordinates of each element of the title bar.

This structure is sent with the WM_GETTITLEBARINFOEX message.

Syntax

typedef struct tagTITLEBARINFOEX {
  DWORD cbSize;
  RECT  rcTitleBar;
  DWORD rgstate[CCHILDREN_TITLEBAR + 1];
  RECT  rgrect[CCHILDREN_TITLEBAR + 1];
} TITLEBARINFOEX, *PTITLEBARINFOEX, *LPTITLEBARINFOEX;

Members

cbSize

Type: DWORD

The size of the structure, in bytes. Set this member to sizeof(TITLEBARINFOEX) before sending with the WM_GETTITLEBARINFOEX message.

rcTitleBar

Type: RECT

The bounding rectangle of the title bar. The rectangle is expressed in screen coordinates and includes all titlebar elements except the window menu.

rgstate[CCHILDREN_TITLEBAR + 1]

Type: DWORD[CCHILDREN_TITLEBAR+1]

An array that receives a DWORD value for each element of the title bar. The following are the title bar elements represented by the array.

Index	Title Bar Element
0	The title bar itself.
1	Reserved.
2	Minimize button.
3	Maximize button.
4	Help button.
5	Close button.

 

Each array element is a combination of one or more of the following values.

Value	Meaning
STATE_SYSTEM_FOCUSABLE 0x00100000	The element can accept the focus.
STATE_SYSTEM_INVISIBLE 0x00008000	The element is invisible.
STATE_SYSTEM_OFFSCREEN 0x00010000	The element has no visible representation.
STATE_SYSTEM_UNAVAILABLE 0x00000001	The element is unavailable.
STATE_SYSTEM_PRESSED 0x00000008	The element is in the pressed state.

rgrect[CCHILDREN_TITLEBAR + 1]

Type: RECT[CCHILDREN_TITLEBAR+1]

An array that receives a structure for each element of the title bar. The structures are expressed in screen coordinates. The following are the title bar elements represented by the array.

Index	Title Bar Element
0	Reserved.
1	Reserved.
2	Minimize button.
3	Maximize button.
4	Help button.
5	Close button.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	winuser.h (include Windows.h)

See also

Conceptual

Reference

WM_GETTITLEBARINFOEX

Windows