delphi中VirtualStringTree树使用方法之终结篇！

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;

-------------------------------------------------------------------------------------------------------------------------------------------------------------------------

终于总结完了，希望对大家有所帮助，欢迎提出宝贵意见，以便改进！