HeaderPane
Main
Hide
Share Link
Print

CaretChange Event, SftTree Object

The caret location changes.

Syntax

C#void object_CaretChange(object sender, EventArgumentType e);
VB.NETPrivate Sub object_CaretChange(ByVal sender As Object, ByVal e As EventArgumentType) Handles object.CaretChange
C++void OnCaretChangeobject(long ItemIndex);
CHRESULT OnCaretChangeobject(long ItemIndex);
VBPrivate Sub object_CaretChange(ByVal ItemIndex As Long)

object

A SftTree object.

ItemIndex

The new zero-based index of the current item.

Comments

The CaretChange event occurs when the caret location changes.

The current item is the item that has the caret rectangle, which is a rectangle outlining the border of the current item (see Items.Current). When using the up and down arrow keys, the user changes the current item (or caret location, also see Items.NoSelection). The current item is not necessarily the same as the selected item. The Item.Selected property can be used to change the selected item.

ItemIndex may be 0, even if the tree control is empty.

The current item can also be affected by the Items.DropHighlightStyle property.

Examples

C# View entire sample code

                                if (sortedColumn == 3)
                                    axSftTree1.Items.SortDependents(itemIndex, sortedColumn, SftTreeSortTypeConstants.sortSftTreeDscCellItemData);
                                else
                                    axSftTree1.Items.SortDependents(itemIndex, sortedColumn, SftTreeSortTypeConstants.sortSftTreeDescending);
                            }
                            itemIndex = axSftTree1.get_Item(itemIndex).NextSibling;
                        } while (itemIndex >= 0);
                    }
                    // update column headers by calling CaretChange
                    axSftTree1_CaretChange(this, new _DSftTreeEvents_CaretChangeEvent(axSftTree1.Items.Current));
                }
            }
        }

        private void axSftTree1_ItemDblClick(object sender, AxSftTreeLib80._DSftTreeEvents_ItemDblClickEvent e) {
            SftTreeAreaTypeConstants area = (SftTreeAreaTypeConstants) e.areaType; 

VB.NET View entire sample code

        AxSftTree1.Splitter.MakeOptimal()
        ' allow sorting
        AxSftTree1.Headers.SortIndicators = SftTreeHeaderSortIndicatorsConstants.headerSortIndicatorsSftTreeAuto

        AxSftTree1.Items.Current = 0
        AxSftTree1_CaretChange(Me, New _DSftTreeEvents_CaretChangeEvent(0))
    End Sub

    Private Sub AxSftTree1_CaretChange(ByVal sender As Object, ByVal e As AxSftTreeLib80._DSftTreeEvents_CaretChangeEvent) Handles AxSftTree1.CaretChange
        ' set column headers based on selected item
        Dim ID As Integer
        ID = AxSftTree1.get_Item(e.itemIndex).ID
        If ID = m_InboxFolder Or ID = m_OutboxFolder Or ID = m_SavedFolder Or ID = m_DeletedFolder Then
            AxSftTree1.get_Header(0).Text = "Folder"
            AxSftTree1.get_Header(1).Text = "Description"
            AxSftTree1.get_Header(2).Text = "" ' we can use this to merge the adjacent title

C++ View entire sample code

                            m_vTree->Items->SortDependents(ItemIndex, sortedColumn, sortSftTreeDscCellItemData);
                        else
                            m_vTree->Items->SortDependents(ItemIndex, sortedColumn, sortSftTreeDescending);
                    }
                    ItemIndex = m_vTree->Item[ItemIndex]->NextSibling;
                } while (ItemIndex >= 0);
            }
        } 
        // update column headers by calling CaretChange
        OnCaretChangeSftTree1(m_vTree->Items->Current);
    }
}

void CEmailDlg::OnItemDblClickSftTree1(long ItemIndex, short ColIndex, short AreaType, short Button, short Shift) 
{
    if (AreaType == constSftTreeText || AreaType == constSftTreeButton) {

See Also SftTree Object | Object Hierarchy


Last Updated 11/03/2026 - (email)
© 2026 Softel vdm, Inc.