Renaming items – PB Docs 2019

If you enable the TreeView’s EditLabels property, the user can
edit an item label by clicking twice on the text.

Events

There are two events associated with editing labels.

The BeginLabelEdit event occurs after the second click when the
EditLabels property is set or when the EditLabel function is called. You
can disallow editing with a return value of 1.

This script for BeginLabelEdit prevents changes to labels of level
2 items:

TreeViewItem tvi
This.GetItem(handle, tvi)
IF tvi.Level = 2 THEN 
   RETURN 1
ELSE
   RETURN 0
END IF

The EndLabelEdit event occurs when the user finishes editing by
pressing enter, clicking on another item, or clicking in the text entry
area of another control. A script you write for the EndLabelEdit event
might validate the user’s changes for example, it could invoke a
spelling checker.

EditLabel function

For control over label editing, the BeginLabelEdit event can
prohibit editing of a label, as shown above. Or you can set the
EditLabels property to FALSE and call the EditLabel function when you
want to allow a label to be edited.

When you call the EditLabel function, the BeginLabelEdit event
occurs when editing begins and the EndLabelEdit event occurs when the
user presses enter or the user clicks another item.

This code for a CommandButton puts the current item into editing
mode:

long h_tvi
h_tvi = tv_1.findItem(CurrentTreeItem!, 0)
tv_1.EditLabel(h_tvi)