SftTree/DLL 7.5 - Tree Control

NextShown

Returns the next visible item.

C

int WINAPI SftTree_GetNextShown(HWND hwndCtl, int index);
int WINAPI SftTreeSplit_GetNextShown(HWND hwndCtl, int index);

C++

int CSftTree::GetNextShown(int index) const;
int CSftTreeSplit::GetNextShown(int index) const;

Parameters

hwndCtl

The window handle of the tree control.

index

The zero-based index of the item after which the next visible item should be located. To locate the first visible item (if present) in a tree control specify -1.

Returns

The return value is the index of the next visible item or -1 if no item is visible.

Comments

The GetNextShown function returns the next visible item.

GetNextShown is used to find the next visible item, given an item index. Dependent items of a collapsed parent item are skipped using this function.

GetPrevShown can be used to retrieve the previous visible item.

Examples

C

    for ( ; ; ) {
        // position to a valid cell
        if (dispCol < firstDispCol) {
            index = SftTree_GetPrevShown(g_hwndTree, index);// try previous item
            dispCol = lastDispCol;
        }
        if (dispCol > lastDispCol) {
            index = SftTree_GetNextShown(g_hwndTree, index);// try next item
            if (index < 0)
                index = 0;
            dispCol = firstDispCol;
        }
        if (index < 0)
            index = lastShown;
        if (index > lastShown)
            index = 0;

View Entire Sample Code

C++

    for ( ; ; ) {
        // position to a valid cell
        if (dispCol < firstDispCol) {
            index = m_Tree.GetPrevShown(index);// try previous item 
            dispCol = lastDispCol;
        }
        if (dispCol > lastDispCol) {
            index = m_Tree.GetNextShown(index);// try next item 
            if (index < 0)
                index = 0;
            dispCol = firstDispCol;
        }
        if (index < 0)
            index = lastShown;
        if (index > lastShown)
            index = 0;

View Entire Sample Code

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