Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxCustomTreeView.IsEditing Method

Indicates whether the user is currently editing a node caption.

#Declaration

Delphi
function IsEditing: Boolean;

#Returns

Type
Boolean

#Remarks

Use the IsEditing method to determine whether the user is currently editing a node caption. If so, the method returns True. Otherwise, False. Note that node editing is only allowed if the ReadOnly property of the tree view is set to False.

The sample code below shows how to toggle the editing mode for the currently selected node in response to pressing specific keys. The F2 key toggles the editing mode for the currently selected node. The ESC key stops node caption editing without saving changes made. The OnKeyDown event of the tree view control is handled to respond to key press events.

Delphi
procedure TForm1.cxTreeView1KeyDown(Sender: TObject; var Key: Word;
  Shift: TShiftState);
var SelectedNode: TTreeNode;
begin
  SelectedNode := cxTreeView1.Selected;
  if SelectedNode = nil then Exit;
  if Key = VK_F2 then
  begin
    if cxTreeView1.IsEditing then
      TreeView_EndEditLabelNow(SelectedNode.Handle, False)
    else
      TreeView_EditLabel(SelectedNode.Handle, SelectedNode.ItemId);
  end;
  if (Key = VK_ESCAPE) and cxTreeView1.IsEditing then
    TreeView_EndEditLabelNow(SelectedNode.Handle, True);
end;

Please refer to the Tree-View Label Editing, TreeView_EditLabel and TreeView_EndEditLabelNow topics of the Windows SDK help system for details on editing node captions at runtime.

See Also