SftTree/DLL 7.5 - Tree Control

CellRectInfo

Returns the location of a cell, the cell text and cell picture.

C

BOOL WINAPI SftTree_GetCellRectInfo(HWND hwndCtl,
        int index,
        int realCol,
        LPRECT lpCellRect,
        LPRECT lpPictureRect,
        LPRECT lpTextRect);
BOOL WINAPI SftTreeSplit_GetCellRectInfo(HWND hwndCtl,
        int index,
        int realCol,
        LPRECT lpCellRect,
        LPRECT lpPictureRect,
        LPRECT lpTextRect);

C++

BOOL CSftTree::GetCellRectInfo(int index,
        int realCol,
        LPRECT lpCellRect,
        LPRECT lpPictureRect = NULL,
        LPRECT lpTextRect = NULL) const;
BOOL CSftTreeSplit::GetCellRectInfo(int index,
        int realCol,
        LPRECT lpCellRect,
        LPRECT lpPictureRect = NULL,
        LPRECT lpTextRect = NULL) const;

Parameters

hwndCtl

The window handle of the tree control.

index

The zero-based index of the item for which the cell position is to be retrieved.

realCol

The zero-based column number of the cell for which the position is to be retrieved.

lpCellRect

A pointer to a RECT structure where the location of the cell is returned (in pixels).

lpPictureRect

A pointer to a RECT structure where the location of the cell picture is returned (in pixels). This parameter may be NULL. If a cell doesn't have a cell picture, an empty rectangle is returned.

lpTextRect

A pointer to a RECT structure where the location of the cell text is returned (in pixels). This parameter may be NULL. If a cell doesn't have cell text, an empty rectangle is returned.

Returns

GetCellRectInfo returns TRUE if successful, otherwise FALSE is returned.

Comments

GetCellRectInfo is provided for compatibility with SftTree/DLL 4.5 (and earlier) only. Applications should use the GetCellRectInfoEx function instead.

The GetCellRectInfo function returns the location of a cell, the cell text and cell picture.

The returned rectangles lpRect, lpPictureRect and lpTextRect are clipped to the tree control's client area and are adjusted for horizontal scrolling.

GetDisplayCellRect can be used to retrieve the coordinates of a cell. GetItemRect returns the coordinates of an entire item.

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