C++Builder中ListView控件用法和示例总结整理

示例1(此示例转自ccrun 妖哥)：

__fastcall TForm1::TForm1(TComponent* Owner)
    : TForm(Owner)
{
    // 切换ListView的显示风格为详细信息
    ListView1->ViewStyle = vsReport;

    // 清除ListView所有列和行的内容
    ListView1->Columns->Clear();
    ListView1->Items->Clear();
}
//---------------------------------------------------------------------------

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    // 添加第一列
    TListColumn *lc = ListView1->Columns->Add();
    lc->Caption = "第一列";
    lc->Width = 120;

    // 添加第二列
    lc = ListView1->Columns->Add();
    lc->Caption = "第二列";
    lc->Width = 80;

    // 添加第三列
    lc = ListView1->Columns->Add();
    lc->Caption = "第三列";
    lc->Width = 100;

    Application->ProcessMessages();

    // 修改第二列的标题
    ShowMessage("点击确定后修改第二列的标题");
    if (ListView1->Columns->Count > 1)
    {
        lc = ListView1->Columns->Items[1];

        lc->Caption = "第二列新标题";
        lc->Width = 120;
    }

    // 添加第一行数据
    TListItem *li = ListView1->Items->Add();
    li->Caption = "一行一列";
    li->SubItems->Add("一行二列");
    li->SubItems->Add("一行三列");

    // 添加第二行数据
    li = ListView1->Items->Add();
    li->Caption = "二行一列";
    li->SubItems->Add("二行二列");
    li->SubItems->Add("二行三列");

    // 添加第三行数据
    li = ListView1->Items->Add();
    li->Caption = "二行一列";
    li->SubItems->Add("二行二列");
    li->SubItems->Add("二行三列");

    //加Application->ProcessMessages()只是为了让窗口处理一下其他的消息,界面上的显示更新一下而已.在有些情况下,窗口内容变化但界面没有刷新时,可以加这么一句.
    Application->ProcessMessages();

    // 修改第三行的数据
    ShowMessage("点击确定后修改第三行的数据");
    if (ListView1->Items->Count > 2)
    {
        li = ListView1->Items->Item[2];

        li->Caption = "二行一列新内容";
        li->SubItems->Strings[0] = "二行二列新内容";
        li->SubItems->Strings[1] = "二行三列新内容";
    }
}

示例2：　

ListView右键点击图标弹出菜单的用法

将ListView的PopupMenu属性设为MyPopupMenu,这样只要选中ListView点右键即可出现我的MyPopupMenu菜单。

但这种方式，无论右击ListView上的任何位置，都会弹出菜单，要想必须选中某个子项后才能进行菜单事件的话，可以在菜单事件中加入判断，没有选中则返回

if(ListView1->Selected == NULL)
  return;

 

另一种方式是，将ListView的PopupMenu属性留空，在ListView的OnMouseDown事件中处理

void __fastcall TMainForm::ListView1MouseDown(TObject *Sender, TMouseButton Button,
		  TShiftState Shift, int X, int Y)
{
  //不是右击或者没有点中则返回，不作反应
  if(Button != mbRight || NULL==ListView1->GetItemAt(X, Y))
	 return;

  //只点选图标，不能点文字，可以加以下3行
  THitTests ht=ListView1->GetHitTestInfoAt(X,Y);
  if(!ht.Contains(htOnIcon))
	 return;

  PopupMenuZW->Popup(Mouse->CursorPos.x, Mouse->CursorPos.y);
}

 

示例3

多个ListView共用一个PopupMenu，菜单事件中要传递被选中的项目信息，如果是数字，可以在点击事件中复制给PopupMenu的Tag,在菜单事件中调用Tag值即可，如果是文字信息，目前想到的是如下方法：

void __fastcall TMainForm::N2Click(TObject *Sender)
{
	if (PopupMenuZW->PopupComponent->Name=="ListView1")
	{
	  if(ListView1->Selected == NULL)
		return;

	  Edit4->Text=ListView1->Selected->Caption;
	}

	if (PopupMenuZW->PopupComponent->Name=="ListView2")
	{
	  if(ListView2->Selected == NULL)
		return;

	  Edit4->Text=ListView2->Selected->Caption;
	}

	if (PopupMenuZW->PopupComponent->Name=="ListView3")
	{
	  if(ListView3->Selected == NULL)
		return;

	  Edit4->Text=ListView3->Selected->Caption;
	}

	if (PopupMenuZW->PopupComponent->Name=="ListView4")
	{
	  if(ListView4->Selected == NULL)
		return;

	  Edit4->Text=ListView4->Selected->Caption;
	}

	if (PopupMenuZW->PopupComponent->Name=="ListView5")
	{
	  if(ListView5->Selected == NULL)
		return;

	  Edit4->Text=ListView5->Selected->Caption;
	}

}

 

示例4　　

获取ListView中某行某列的值，可以

ListView1->Items->Item[i]->Caption = "第i行第1列的值";
ListView1->Items->Item[i]->SubItems->Strings[0]= "第i行第2列的值";
ListView1->Items->Item[i]->SubItems->Strings[1]= "第i行第3列的值";
ListView1->Items->Item[i]->SubItems->Strings[2]= "第i行第4列的值";
　　

已知某项的值，修改对应的图标，目前想到的方法是

 for(int i=0;i<=ListView1->Items->Count-1;i++)
 {
     if(ListView1->Items->Item[i]->Caption=="5排8座")
     {
	  ListView1->Items->Item[i]->ImageIndex=1;
	  break;
     }
 }

　　

其他搜集到的示例：

转自C++Builder 移动开发研究 (92227302) QQ群
让ListView控件失去焦点后仍保持选中状态：

void __fastcall TForm1::FormCreate(TObject *Sender)
{
  ListView1->HideSelection = false; // 失去焦点后仍保持选中状态
  //suiTreeView1->HideSelection = false; // 失去焦点后仍保持选中状态
}

对suiDBMemo控件等同样适用，但ListBox控件没有这样的属性。

使用图标：

  //ListView1->LargeImages=ImageList1; // 设置存放大图标的图标列表，当列表处于大图标显示方式时，列表使用这个图标列表中的图标显示
  ListView1->SmallImages=ImageList1; // 设置存放小图标的图标列表，当列表处于小图标显示方式时，列表使用这个图标列表中的图标显示
  //ListView1->StateImages=ImageList1; // 状态图标，用不同的的图像来表示节点的不同状态
  // 如果要在不是当前被选中的节点的左边显示图像，那么应该在编辑框Image Index
  // 中输入图像的索引号。要禁止显示图像可以把这个节点Image Index设置为缺省值-1。
  // 如果要在被选中的节点的左边显示图像，应该在编辑框Selected Index中指定图像的索引号，索引号是从0开始的。要禁止显示图像可以把它设置为缺省值-1。
  // 如果要在节点的左边多显示一个图像，可以在编辑框State Index中输入图像的索引号。这个索引号代表Tree View组件中的StateImages属性所表示的图像列表的索引。要禁止显示图像可以把这个项目设置为缺省值-1。
  // 注意：Image Index与 Selected Index 使用的是Images指定的ImageList；而State Index使用的是StateImages 指定的ImageList。

  ListView1->Items->Item[ListView1->Items->Count-1]->ImageIndex=0; // 最后一个节点是使用第一个图标

1、常用代码：

void __fastcall TForm1::Button2Click(TObject *Sender)
{
  //Edit1->Text=ListView1->SelCount; // 取得被选中的节点总数

  //ListView1->Selected->ImageIndex=1; // 改变选中节点图标

    //if(suiListView1->Items->Count<=0) // 判断是否为空

  //Edit1->Text=ListView1->Items->Count; // 取得节点总数

  //ListView2->Items=ListView1->Items; // 在两个ListView控件之间传递结构

  //ListView1->Items->Item[a] = ListView1->Items->Item[a+1]; // 在两个节点之间传递结构

  //ListView1->Items->Add()->Caption = Edit1->Text; // 增加新节点

  //ListView1->Items->Add()->SubItems->Add("str"); // 仅增加子节点

  //ListView1->RowSelect = true; // 允许整行选中

  //ListView1->Clear(); // 清空
  或：
  //ListView1->Items->Clear(); // 清空

  //Edit1->Text=ListView1->Items->Count; // 取得总行数

  //Edit1->Text=ListView1->Selected->Index; // 取得选中行的行号
  或：
  //Edit1->Text=ListView1->Items->IndexOf(ListView1->Selected); // 取得选中行的行号

  //Edit1->Text=ListView1->Selected->SubItems->Text; // 取得选中节点下所有子节点的文本，不同节点的文本之间用空格分开

  //ListView1->Selected->Delete(); // 从ListView视图中将选中的条目删除

  //Memo1->Lines->Add(ListView1->Items->Item[0]->Top); // 指定节点的竖向位置

  //Memo1->Lines->Add(ListView1->Items->Item[0]->Left); // 指定节点的横向位置

  //Edit1->Text=ListView1->Items->Item[0]->Caption; // 取得指定节点的文本

  //Edit1->Text=ListView1->Selected->Caption; // 取得选中节点的文本
  或：
  //Edit1->Text=ListView1->Items->Item[ListView1->Selected->Index]->Caption; // 取得选中节点的文本

  //ListView1->Items->Item[0]->Caption = "sdfs"; // 修改第一层指定节点的文本

  //ListView1->Items->Item[ListView1->Items->Count-1]->SubItems->Add("buffer"); // 在最后一行追加子节点

  //ListView1->Items->Item[0]->SubItems->Add("buffer"); // 在指定行追加子节点
  // 本教程由 C++Builder 移动开发研究 (92227302) QQ群原创并群内首发，转载请注明出处，谢谢合作！
  ListView1->ViewStyle=vsIcon; // 大图标
  //ListView1->ViewStyle=vsSmallIcon; // 小图标
  //ListView1->ViewStyle=vsList; // 列表
  //ListView1->ViewStyle=vsReport; // 详细资料
}

3、追加节点：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
  //ListView1->Clear(); // 清空
  ListView1->Items->Add(); // 增加节点
  ListView1->Items->Item[ListView1->Items->Count-1]->Caption = "hniuh"; // 给节点命名
}

4、当鼠标指针移动到节点上时，改变字体颜色为蓝色：

void __fastcall TForm1::FormCreate(TObject *Sender)
{
  ListView1->HotTrack=true; // 当鼠标指针移动到节点上时，改变字体颜色为蓝色
}
  或：
void __fastcall TForm1::ListView1CustomDrawItem(TCustomListView *Sender,
      TListItem *Item, TCustomDrawState State, bool &DefaultDraw)
{
  ListView1->HotTrack=true; // 当鼠标指针移动到节点上时，改变字体颜色为蓝色
}

5、禁止用户通过鼠标直接点击的方法修改节点的文本：

void __fastcall TForm1::FormCreate(TObject *Sender)
{
  ListView1->ReadOnly=true; // 禁止用户直接修改节点的标题
}

6、设置指定的行处于选中状态：

void __fastcall TForm1::Button2Click(TObject *Sender)
{
  ListView1->Items->Item[0]->Selected=True; // 设置指定的行处于选中状态，行号从0开始
  ListView1->SetFocus(); // 获得焦点
  或：
  //ListView1->Selected = ListView1->Items->Item[0];
  //ListView1->SetFocus(); // 获得焦点
}

7、在控件中增加新列并显示列图标：

void __fastcall TForm1::Button2Click(TObject *Sender)
{
  TListColumn* NewColumn; // 列表列
  //ListView1->RowSelect = true; // 准许可以整行选中
  NewColumn = ListView1->Columns->Add(); // 增加一列
  NewColumn->Caption = "自转周期(天)"; // 列的名称
  NewColumn->Width = 100; // 列的宽度
  NewColumn->ImageIndex=1; // 列头图标号
  //delete NewColumn; // 使用后添加的项目被清除
}

8、添加新节点并指定节点图标：

void __fastcall TForm1::Button2Click(TObject *Sender)
{
  //ListView1->Clear(); // 清空
  TListItem * pList = ListView1->Items->Add();
  pList->Caption = Edit1->Text;
  pList->SubItems->Add("str");
  pList->ImageIndex=1;
  //delete pList; // 使用后添加的项目被清除
}

9、更换选中节点的图标：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    if(ListView1->SelCount>0) // 如果有节点被选中
      ListView1->Selected->ImageIndex=1; // 更换选中节点的图标
}

10、更换所有节点的图标：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    for(int i=0;i<=ListView1->Items->Count-1;i++){
      ListView1->Items->Item[i]->ImageIndex=1;
    }
}