Skip to main content
Table of Contents

TTMSFNCCheckedTreeView.CheckedNodes Method

Returns checked nodes from the tree view.

API unit family: TMSFNCCheckedTreeView Declaring type: TTMSFNCCheckedTreeView

Syntax

FMX.TMSFNCCheckedTreeView.hppPascalC++
function CheckedNodes(AColumn: Integer = 0; ARecurse: Boolean = True): TTMSFNCTreeViewCheckedNodes; virtual;
virtual TTMSFNCTreeViewCheckedNodes __fastcall CheckedNodes(int AColumn = 0x0, bool ARecurse = true);

Parameters

Name Description
AColumn Zero-based column index to inspect. The default value is 0.
ARecurse When True, includes checked nodes from child collections.

Returns

Array containing the checked nodes in traversal order.

Usage examples

Collect checked nodes

Reads checked nodes recursively and builds a display summary.

Collect checked nodesPascalC++
procedure TForm1.ShowCheckedNodes;
var
  Nodes: TTMSFNCTreeViewCheckedNodes;
  Node: TTMSFNCTreeViewNode;
  Summary: string;
begin
  Nodes := TMSFNCCheckedTreeView1.CheckedNodes(0, True);
  Summary := '';

  for Node in Nodes do
  begin
    if Summary <> '' then
      Summary := Summary + ', ';

    Summary := Summary + Node.Text[0];
  end;

  ShowMessage(Summary);
end;

void __fastcall TForm1::ShowCheckedNodes()
{
  TTMSFNCTreeViewCheckedNodes Nodes = TMSFNCCheckedTreeView1->CheckedNodes(0, true);
  System::UnicodeString Summary = "";

  for (int i = 0; i < Nodes.Length; i++)
  {
    TTMSFNCTreeViewNode *Node = Nodes[i];
    if (Summary != "")
      Summary = Summary + ", ";

    Summary = Summary + Node->Text[0];
  }

  ShowMessage(Summary);
}

Read the related guide