VirtualStringTree 的用法详解：
作者：张志宝go淘宝
例子：创建了一个树名为VirtualStringTree1，第一列显示数据库字段ID的值，标题为编号；第二列显示字段Name的值，标题为名字。
一、【TVirtualStringTree常用属性】
BorderStyle :设置边框选项 bsSingle设置单边框
为TVirtualStringTree添加列及列标题：
Header--Columns : 设置列 点击“…”，在弹出界面点击add new按钮，就增加一列，在其text中输入列名,在width输入列宽度；
Header--options-hovisible: 设置列可显示！！
Header-Style :设置树的主题类型
ScrollBaroptions--AlwaysVisible 滚动条是否总是可见
ScrollBarOptions-ScrollBars-ssVertical 设置为只有竖向滚动条
为TVirtualStringTree添加勾选框、选择框、复选框：
TreeOptions----MiscOpitions---toCheckSupport 设置为True即可
CheckImageKind 为勾选框设置图标
Header-Maincolumn 设置勾选框在第几列前面，默认为0也就是在第一列前面
并设置ongettext()事件和onInitailNode()事件，见下面事件部分。
--------------------------------------------------------------------------------------------------------------------------------------------
二、 【TVirtualStringTree常用方法 】
VirtualStringTree1.NodeDataSize := sizeOf(TMyNodeData); //设置占存储空间大小
树节点选中：VirtualStringTree1.Selected[p_node]True; //设置节点p_node处于选中状态
树节点勾选框选中:p_node.CheckState:=cscheckedNormal;//设置节点p_node处于勾选状态
onchecked()事件：设置节点勾选时触发的事件，其中第二个参数就是勾选的节点
取消选中的节点：VirtualStringTree1.ClearSelection;
树节点删除: VirtualStringTree1.DeleteSelectedNodes; //删除选中的节点
树节点内容清空：VirtualStringTree1.clear;
得到树的第一个节点:VirtualStringTree1.GetFirst;
得到树的第一个选中节点：VirtualStringTree1.GetFirstSelected;
得到节点的下一个节点:VirtualStringTree1.Getnext(p_node);
得到下一个选中的节点:VirtualStringTree1.GetNextSelected(p_node);
得到父节点:p_node.Parent
得到子节点个数:p_node.ChildCount
得到第一个子节点：p_node.FirstChild
得到最后一个子节点：p_node.FirstChild
得到上一个兄弟节点：p_node.PrevSibling
得到下一个兄弟节点：p_node.NextSibling
---------------------------------------------------------------------------------------------------------------------------
三、【TVirtualStringTree显示数据库字段内容】：
//定义一个指针
type
Tjdtransline =record
id: integer; //编号
name : string; //名称
levelID : integer;//级别，例如总公司levelID 为0、二级公司为1、三级公司levelID 为2等
FatherID:integer; //节点的父节点ID
end;
pjdtransline =^Tjdtransline ;
private
procedure iniVirtualStringTree1; //事件声明为全局私有事件
//树显示数据库字段内容
procedure form1.iniVirtualStringTree1;
var
p_jdtransline: pjdtransline;
begin
while not adoquery1.Eof do
begin
New(p_jdtransline);
p_jdtransline^.ID := client_dataset_jdtransline.FieldByName('ID').AsInteger;
p_jdtransline^.Name := Trim(client_dataset_jdtransline.FieldByName('Name').AsString);
VirtualStringTree1.AddChild(nil, p_jdtransline); //*********************添加树节点***********************************
adoquery1.Next;
end;
end;
//在窗体创建时调用树的初始化事件
procedure form1.formcreate(sender:Tobject);
begin
iniVirtualStringTree1;
end;
//设置各列字段的显示OnGetText() var
p_node_data : PMyNodeData;
p_jdtransline : PJDTranslineTree;
begin
p_node_data := VirtualStringTree1.GetNodeData(Node);
p_jdtransline := p_node_data^.my_data_ptr;
case Column of
0 : CellText := inttostr( p_jdtransline^.ID);
1: CellText := p_jdtransline^.Name;
end;
end;
------------------------------------------------------------------------------------------------------------------------------------
四、 【TVirtualStringTree设置节点展开与折叠的图标 】
OnInitNode() //设置结点的节点是否有子节点类型（‘+’、‘—’显示）
begin
Include(InitialStates, ivsHasChildren);
Node.CheckType := ctTriStateCheckBox;
end;
-------------------------------------------------VirtualStringTree树拖动操作实现开始-------------------------------------------------------------------------
五、【VirtualStringTree树节点拖动实现】
主要设置其DragOver和DragDrop事件。其中DragOver控制是否允许移动；DragDrop控制移动后执行的操作。
//一、DragOver事件
procedure form1.VirtualStringTree1Over(
Sender: TBaseVirtualTree; Source: TObject; Shift: TShiftState;
State: TDragState; Pt: TPoint; Mode: TDropMode; var Effect: Integer;
var Accept: Boolean);
//事件内部函数1.获取节点的值
function GetVNodeData(vn: PVirtualNode; vst: TVirtualStringTree): PVNodeData;
begin
Result := PVNodeData(PPointer(vst.GetNodeData(vn))^);
end;
//事件内部函数2.获取所有选中节点的列表
function GetSelectedVNodes(vst: TVirtualStringTree): TVNodeArray;
var
list: TList;
n: PVirtualNode;
i: Integer;
begin
list := TList.Create;
n := vst.GetFirstSelected;
while n <> nil do
begin
list.Add(n);
n := vst.GetNextSelected(n);
end;
SetLength(Result, list.Count);
for i := 0 to list.Count-1 do
begin
Result[i] := list[i];
end;
list.Free;
end;
// //事件内部函数3.判断是否是移动到自己的父节点
function IsSameLevel(selectedList: TVNodeArray): Boolean;
var
n: PVirtualNode;
l: Cardinal;
i: Integer;
begin
Result := False;
if Length(selectedList) = 0 then
begin
Result := True;
Exit;
end;
for i := 0 to High(selectedList) do
begin
n := selectedList[i];
if n.Parent = Sender.DropTargetNode then //移动到自己父节点不允许移动
begin
HintBar.Panels[0].Text := '不允许移动到自己的父节点';
Result := True;
Break;
end;
end;
end;
// //事件内部函数4.判断目标(父、子）节点中是否与选中节点名称相同
function IsExistSelectObject(selectedList: TVNodeArray): Boolean;
var
dstNode : PVirtualNode;
n : PVirtualNode;
i : Integer;
TargetChildNode : PVirtualNode;
TargetParentNode : PVirtualNode;
SelectNodeName : String;
TargetNodeName : String;
TargetChildNodeName : String;
TargetParentNodeName: String;
SelectNodeLevel : Integer;
TargetNodeLevel : Integer;
begin
Result := False;
if Length(selectedList) = 0 then
begin
Exit;
end;
dstNode := Sender.DropTargetNode;
TargetChildNode := dstNode.FirstChild;
TargetParentNode := dstNode.Parent;
TargetNodeName := pjdtransline(VtPurview.GetNodeData(dstNode)^).name;
TargetNodeLevel := pjdtransline(VtPurview.GetNodeData(dstNode)^).LevelID;
for i := 0 to High(selectedList) do
begin
n := selectedList[i];
SelectNodeName := pjdtransline(VtPurview.GetNodeData(n)^).name;
SelectNodeLevel := pjdtransline(VtPurview.GetNodeData(n)^).LevelID;
if (TargetNodeLevel > SelectNodeLevel) then //目标节点级别不能比选中节点级别低
begin
HintBar.Panels[0].Text := '目标节点级别比选中节点级别低，不能移动！';
Result := True;
Break;
end;
if (TargetNodeName = SelectNodeName) then //目标节点与选中节点相同
begin
HintBar.Panels[0].Text := '目标节点值与选中节点值相同，不能移动！';
Result := True;
Break;
end;
while TargetChildNode <> nil do
begin
TargetChildNodeName := pjdtransline(VtPurview.GetNodeData(TargetChildNode)^).name;
if TargetChildNodeName = SelectNodeName then //目标子节点与选中节点相同
begin
HintBar.Panels[0].Text := '目标子节点存在与选中节点值相同的节点，不能移动！';
Result := True;
Break;
end;
TargetChildNode := TargetChildNode.NextSibling;
end;
end;
end;
// //事件内部函数6.判断是否移动自己子节点或子子节点
function IsAncestor(vnDescendant, vnAncestor: PVirtualNode): Boolean;
var
p: PVirtualNode;
begin
Result := False;
p := vnDescendant.Parent;
while p <> nil do
begin
if p = vnAncestor then
begin
HintBar.Panels[0].Text := '不能移动到自己的子节点或子子节点';
Result := True;
Exit;
end;
p := p.Parent;
end;
end;
//事件定义变量
var
Node : TTreeNode;
VirtualStringTree1: TVirtualStringTree;
dstNode, srcNode: PVirtualNode;
srcText, dstText, s: string;
selectedList: TVNodeArray;
i: Integer;
begin
Accept := False;
if not (Source is TVirtualStringTree) then Exit;
VirtualStringTree1 := TVirtualStringTree(Source);
dstNode := Sender.DropTargetNode;
srcNode := VirtualStringTree1.FocusedNode;
if (srcNode = nil) or (dstNode = nil) then Exit;
if srcNode = dstNode then
begin
HintBar.Panels[0].Text := '目标节点必须与选中节点不同！';
Exit;
end;
selectedList := GetSelectedVNodes(VirtualStringTree1);
if IsSameLevel(selectedList) then
begin
Accept := False;
Exit;
end;
if IsExistSelectObject(selectedList) then
begin
Accept := False;
Exit;
end;
// dstText := GetVNodeData(dstNode, VirtualStringTree1).Name;
case Mode of
dmAbove: // 成为父节点;
begin
Accept := False;
end;
dmBelow: // 成为子节点，本例主要采用成为子节点模式
begin
for i := 0 to High(selectedList) do
begin
srcNode := selectedList[i];
Accept := not IsAncestor(dstNode, srcNode);
if not Accept then Break;
end;
end;
dmOnNode: // 成为同级节点
begin
for i := 0 to High(selectedList) do
begin
srcNode := selectedList[i];
Accept := not IsAncestor(dstNode, srcNode);
if Accept then
HintBar.Panels[0].Text := '可以移动'
else
Break;
end;
end;
dmNowhere:
Accept := False;
else
end;
end;
二、DragDrop事件
procedure Tform1.VirtualStringTree1DragDrop(
Sender: TBaseVirtualTree; Source: TObject; DataObject: IDataObject;
Formats: TFormatArray; Shift: TShiftState; Pt: TPoint;
var Effect: Integer; Mode: TDropMode);
//事件内部函数--获取选中节点的list
function GetSelectedVNodes(VtPurview: TVirtualStringTree): TVNodeArray;
var
list: TList;
n: PVirtualNode;
i: Integer;
begin
list := TList.Create;
n := VtPurview.GetFirstSelected;
while n <> nil do
begin
list.Add(n);
n := VtPurview.GetNextSelected(n);
end;
SetLength(Result, list.Count);
for i := 0 to list.Count-1 do
begin
Result[i] := list[i];
end;
list.Free;
end;
var
VirtualStringTree1: TVirtualStringTree;
dstNode, srcNode: PVirtualNode;
selectedList: TVNodeArray;
i: Integer;
TargetNodeID : integer;
SelectNodeID : integer;
SelectNodeFID: integer;
sql_str : string;
begin
VirtualStringTree1 := TVirtualStringTree(Source);
dstNode := Sender.DropTargetNode;
TargetNodeID := PPurview(VtPurview.GetNodeData(dstNode)^).ID;
selectedList := GetSelectedVNodes(VirtualStringTree1);
srcNode := VirtualStringTree1.FocusedNode;
if (srcNode = nil) or (dstNode = nil) then Exit;
case Mode of
dmAbove: // 成为父节点;
begin
end;
dmBelow: // 成为子节点
begin
if IDYES = MessageBox(Handle, PChar('是否将操作保存到数据库？'), '确认保存',MB_ICONQUESTION or MB_YESNO or MB_DEFBUTTON2) then
begin
for i := 0 to High(selectedList) do
begin
srcNode := selectedList[i];
VirtualStringTree1.MoveTo(srcNode, dstNode, amAddChildFirst, False);
SelectNodeID := PPurview(VtPurview.GetNodeData(srcNode)^).ID;
SelectNodeFID := PPurview(VtPurview.GetNodeData(srcNode)^).FatherID;
//执行数据库操作
if sql_str = '' then
sql_str := Format('exec p_VehicleGroupTreeDragMove %d,%d,%d ',
[SelectNodeID,
SelectNodeFID,
TargetNodeID
])
else
sql_str := sql_str + Format(';exec p_VehicleGroupTreeDragMove %d,%d,%d ',
[SelectNodeID,
SelectNodeFID,
TargetNodeID
]);
end;
VirtualStringTree1.Sort(dstNode, 0, sdAscending, False);
end
else
exit;
end;
dmOnNode: // 成为同级节点
begin
end;
dmNowhere:
begin
end;
else
end;
if sql_str<>'' then
begin
ExcuteSQL(sql_str); //保存拖动后节点的上下级关系
end;
end;
-------------------------------------------------VirtualStringTree树拖动操作实现结束-------------------------------------------------------------------------
六、实现VirtualStringTree（TVirtualStringTree）树节点字体颜色分多颜色显示 oncellpaint()事件
客户要求盲区或掉线的字体要显示红色，速度值要显示灰色
代码如下：
procedure TfrmMain.vtActiveVehiclePaintText(Sender: TBaseVirtualTree;
const TargetCanvas: TCanvas; Node: PVirtualNode; Column: TColumnIndex;
TextType: TVSTTextType);
begin
p_node_data := TGPSClientVTVUtils.ExtractActiveVehicleNodeData(vtActiveVehicle, Node); //获取节点data
if not Assigned(p_node_data) then
Exit;
vInfo := PGPSClientVehicleInfoColumn(vtActiveVehicle.Header.Columns[Column].Data);
if vInfo <> nil then
begin
if (Pos('盲区',p_node_data^.CarInfo.GpsInfo.GpsState)>0) and //判断节点值满足某条件
(vInfo^.FieldInfo.FieldName = 'GPS_Speed') then //判断是哪个列，如果是整个节点都变颜色可不需此条件
TargetCanvas.Font.Color := clMedGray; //速度列变灰色
if (Pos('盲区',p_node_data^.CarInfo.GpsInfo.GpsState)>0) and
(vInfo^.FieldInfo.FieldName = 'GPS_Precision') then
TargetCanvas.Font.Color := clred; //精度列变红色
if (SecondsBetween(Now(), p_node_data^.CarInfo.GpsInfo.GPSTime)>=7200) and //盲区条件
(vInfo^.FieldInfo.FieldName = 'GPS_Speed') then //速度列
TargetCanvas.Font.Color := clMedGray;
if (SecondsBetween(Now(), p_node_data^.CarInfo.GpsInfo.GPSTime)>=7200) and
(vInfo^.FieldInfo.FieldName = 'GPS_RealStatus') then
TargetCanvas.Font.Color := clred;
end;
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------
终于总结完了，希望对大家有所帮助，欢迎提出宝贵意见，以便改进！
