基于RAD Studio 11的自定义TListBoxItem与Live Bindings技术咨询

一、TListBox展示复杂内容的最优方案 #

1. 样式书（TStyleBook）自定义布局（推荐） #

• 无需编写自定义控件代码，直接在设计时通过TStyleBook创建自定义TListBoxItem样式：
  • 打开样式编辑器，基于默认ListBoxItemStyle克隆新样式；
  • 在样式中添加多个TText、TImage等控件，调整布局（比如左图标、上下两行文本、右侧状态图标）；
  • 给每个需要绑定的控件设置Name（如txtTitle、txtSubtitle、imgIcon）；
  • 在Live Bindings设计器中，将TFDMemTable的字段分别绑定到样式中控件的对应属性（如Text、Bitmap）；
  • 给TListBox指定这个自定义样式，即可自动复用布局展示每条数据。
• 优势：设计可视化，维护方便，符合RAD Studio快速开发理念，样式可复用在其他列表控件。

2. 代码创建自定义TListBoxItem（灵活度高） #

• 若需动态调整布局或处理复杂逻辑，可通过代码继承TListBoxItem创建自定义类：

  class TCustomListBoxItem : public TListBoxItem
  {
  public:
      __fastcall TCustomListBoxItem(TComponent* Owner);
      void __fastcall BindData(TFDMemTable* DataSource, int Row);
  private:
      TText* FTitleText;
      TText* FSubText;
      TImage* FIconImage;
  };
  
  __fastcall TCustomListBoxItem::TCustomListBoxItem(TComponent* Owner)
      : TListBoxItem(Owner)
  {
      // 创建内部控件并设置布局
      FTitleText = new TText(this);
      FTitleText->Parent = this;
      FTitleText->Align = TAlignLayout::Top;
      FTitleText->Font->Size = 14;
  
      FSubText = new TText(this);
      FSubText->Parent = this;
      FSubText->Align = TAlignLayout::Top;
      FSubText->Font->Size = 12;
      FSubText->TextColor = TAlphaColorRec::Gray;
  
      FIconImage = new TImage(this);
      FIconImage->Parent = this;
      FIconImage->Align = TAlignLayout::Left;
      FIconImage->Width = 40;
  }
  
  void __fastcall TCustomListBoxItem::BindData(TFDMemTable* DataSource, int Row)
  {
      DataSource->RecNo = Row;
      FTitleText->Text = DataSource->FieldByName("Title")->AsString;
      FSubText->Text = DataSource->FieldByName("Subtitle")->AsString;
      // 绑定图标：可从字段加载本地路径或网络图片
      FIconImage->Bitmap->LoadFromFile(DataSource->FieldByName("IconPath")->AsString);
  }
  

• 使用时，在TListBox的OnUpdateObjects事件中复用自定义Item，避免重复创建控件提升性能：

  void __fastcall TForm1::ListBox1UpdateObjects(TObject *Sender, TListBoxItem *Item)
  {
      TCustomListBoxItem* CustomItem = dynamic_cast<TCustomListBoxItem*>(Item);
      if (!CustomItem)
      {
          CustomItem = new TCustomListBoxItem(ListBox1);
          Item->ReplaceComponent(CustomItem);
      }
      CustomItem->BindData(FDMemTable1, ListBox1->Items->IndexOf(Item));
  }
  

• 优势：完全自定义逻辑，适配特殊业务场景，控件复用机制能减少内存开销。

3. 结合Live Bindings的ItemTemplate（简化绑定） #

• 在TListBox的ItemTemplate属性中直接拖入控件布局，无需样式书：
  • 选中TListBox，在Object Inspector中展开ItemTemplate，点击Edit Custom Template；
  • 在模板中添加TText、TImage等控件，设置布局；
  • 打开Live Bindings设计器，将TFDMemTable的字段绑定到模板中控件的属性；
  • 启用TListBox的AutoBindings，数据会自动填充到每个Item的模板中。
• 优势：比样式书更轻量，适合快速搭建简单复杂布局。

二、性能优化建议（针对数据处理、加载、过滤、展示） #

1. TFDMemTable优化 #

• 提前定义字段结构：不要使用动态字段，根据API返回的JSON结构在设计时创建对应字段，避免运行时动态创建字段的开销；
• 批量加载数据：使用FDMemTable->BatchMove或一次性添加所有记录，避免逐条调用Append/Post；
• 开启索引：对常用过滤、排序的字段创建索引（FDMemTable->IndexFieldNames = "FieldName"），提升过滤和排序速度；
• 禁用控件更新：加载数据前调用ListBox1->BeginUpdate()，加载完成后调用ListBox1->EndUpdate()，避免频繁刷新界面。

2. Live Bindings优化 #

• 使用TAdapterBindSource作为中间层：将TFDMemTable连接到TAdapterBindSource，再绑定到TListBox，减少直接绑定的开销；
• 禁用不必要的绑定事件：关闭TAdapterBindSource的AutoRefresh，在数据加载完成后手动调用Refresh()；
• 使用虚拟模式：若数据量极大（万级以上），启用TListBox的VirtualMode，仅渲染可见区域的Item，大幅降低内存占用和渲染时间。

3. 数据处理优化 #

• JSON转TFDMemTable直接批量处理：使用TFDJSONDataSets组件，将API返回的JSON直接导入TFDMemTable，无需手动解析JSON到对象，减少中间环节；
• 异步加载数据：在后台线程中下载JSON并填充TFDMemTable，避免阻塞UI线程，提升应用响应速度；
• 过滤逻辑优化：使用TFDMemTable->Filter和Filtered属性进行过滤，而非手动遍历TList，数据库引擎的过滤效率远高于手动处理。

内容的提问来源于stack exchange，提问作者arend