Returns the dimensions of the column header area.

C

void WINAPI SftTree_GetHeaderRect(HWND hwndCtl,
        int iCol,
        LPRECT lpRect);
void WINAPI SftTreeSplit_GetHeaderRect(HWND hwndCtl,
        int iCol,
        LPRECT lpRect);

C++

void CSftTree::GetHeaderRect(int iCol, LPRECT lpRect) const;
void CSftTreeSplit::GetHeaderRect(int iCol, LPRECT lpRect) const;

Parameters

hwndCtl

The window handle of the tree control.

iCol

The zero-based column number whose location is to be retrieved.  If -1 is specified, the location of the entire column header area is returned.

lpRect

A pointer to a RECT structure where the location of the requested column header is returned.

Comments

The GetHeaderRect function returns the dimensions of the column header area.

GetHeaderRect does not handle merged column headers.  If cell or column merging is used, GetDisplayHeaderRect should be used instead.

An empty rectangle is returned if an invalid column number is specified or column headers are not shown (see SetShowHeader).

The coordinates returned in lpRect are coordinates relative to the tree control's client area (in pixels).

The row/column header area can be retrieved using GetRowColHeaderRect. 

See Also  C/C++ API  |  Categories |  Notifications