TITLEBARINFOEX structure

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

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

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

   
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