C++ Builder 枚举窗口内所有的控件

C++ Builder 参考手册 ➙ 枚举窗口内所有的控件

---

• 枚举窗口内所有的控件的方法
  枚举所有的控件显示在 Memo1 里面
  枚举所有的控件显示在树形结构里面
  窗口上所有的编辑框都清空

---

枚举窗口内所有的控件的方法

从 TWinControl 继承过来的控件可以当作容器控件，例如 TPanel、TGroupBox 和 TScrollBox 等，窗口 TForm 也是从 TWinControl 继承过来的，所以只要可以枚举 TWinControl 里面的控件，就可以做一个通用的枚举控件的函数。

TWinControl 类里面的 ControlCount 属性是这个容器控件或窗口里面有多少个控件，Controls[i] 是第 i 个控件，是 TControl 类型的。

TControl 是所有的控件都共有的父类，这个类的 Name 属性是控件的名称，例如 Edit1，Button1 或 Memo1 等，如果改成其他名字，这里看到的是改名之后的名称；这个类的 ClassName() 方法可以得到控件的类名，例如 TEdit，TButton 或 TMemo 等。

枚举到的 TControl 可以通过 dynamic_cast 类型转换到对应的类型，同时可以判断是否是这个类型的控件，如果是 TWinControl 说明这个控件可能是容器控件，递归调用枚举控件函数可以得到这个容器内的其他控件。

例1. 枚举所有的控件显示在 Memo1 里面

void TForm1::EnumAllControls(TWinControl *pWinCtrl)
{
    int iCtrlCount = pWinCtrl->ControlCount; // pWinCtrl 里面的控件个数
    for(int i = 0; i < iCtrlCount; i++)
    {
        TControl *pControl = pWinCtrl->Controls[i]; // pWinCtrl 里面的第 i 个控件
        Memo1->Lines->Add(pControl->Name + L": " + pControl->ClassName());

        TWinControl *pwc = dynamic_cast(pControl); // 这个控件是不是容器？
        if(pwc) // 如果这个控件是容器
        {
            EnumAllControls(pwc); // 递归显示这个容器控件里面的控件
        }
    }
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button1Click(TObject *Sender)
{
    EnumAllControls(this); // 显示 this 里面所有的控件
}
//---------------------------------------------------------------------------

运行结果：

枚举所有的控件运行结果

例2. 枚举所有的控件显示在树形结构里面

void TForm1::EnumAllControls1(TWinControl *pWinCtrl, TTreeNode *pTreeNode)
{
    int iCtrlCount = pWinCtrl->ControlCount; // pWinCtrl 里面的控件个数
    for(int i = 0; i < iCtrlCount; i++)
    {
        TControl *pControl = pWinCtrl->Controls[i]; // pWinCtrl 里面的第 i 个控件
        TTreeNode *pNode = TreeView1->Items->AddChild(pTreeNode, pControl->Name);

        TWinControl *pwc = dynamic_cast(pControl); // 这个控件是不是容器？
        if(pwc) // 如果这个控件是容器
        {
            EnumAllControls1(pwc, pNode); // 递归显示这个容器控件里面的控件
        }
    }
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button2Click(TObject *Sender)
{
    EnumAllControls1(this, NULL);
}

枚举所有的控件显示在树形结构里面

例3. 窗口上所有的编辑框都清空

void TForm1::ClearAllEdits(TWinControl *pWinCtrl)
{
    int iCtrlCount = pWinCtrl->ControlCount; // pWinCtrl 里面的控件个数
    for(int i = 0; i < iCtrlCount; i++)
    {
        TControl *pControl = pWinCtrl->Controls[i]; // pWinCtrl 里面的第 i 个控件

        TEdit *pEdit = dynamic_cast(pControl); // 这个控件是不是 TEdit 编辑框
        if(pEdit) // 这个控件是 TEdit 编辑框
        {
            pEdit->Clear(); // 清空编辑框
        }

        TWinControl *pwc = dynamic_cast(pControl); // 这个控件是不是容器？
        if(pwc) // 如果这个控件是容器
        {
            ClearAllEdits(pwc); // 递归显示这个容器控件里面的控件
        }
    }
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button3Click(TObject *Sender)
{
    ClearAllEdits(this);
}
//---------------------------------------------------------------------------

运行结果：点击 Button3 之前编辑框里面都有内容，点击 Button3 之后清空所有的编辑框。

点击 Button3 之前编辑框里面都有内容

点击 Button3 之后清空所有的编辑框

---

相关：

• 枚举控件所有的属性、事件和方法

---

C++ Builder 参考手册 ➙ 枚举窗口内所有的控件