TComponent::ValidateRename - C++

C++ Builder 参考手册 ➙ TComponent ➙ ValidateRename

头文件：#include <System.Classes.hpp>
命名空间：System::Classes
类：TComponent
访问权限：protected:
函数原型：

virtual void __fastcall ValidateRename(
    TComponent* AComponent, 
    const System::UnicodeString CurName, 
    const System::UnicodeString NewName);

System::Classes::TComponent::ValidateRename 是 System::Classes::TComponent 的成员函数，在给组件改名的时候会调用这个函数，检查名称是否有效。

参数：

AComponent：给这个组件改名的时候，检测这个组件的名称是否有效；
CurName ：组件当前的名称；
NewName：组件新的名称；

返回值：

无。

• 在给组件改名的时候会调用这个函数，检查名称是否有效；
• 在 InsertComponent 的时候，使用 ValidateRename 方法检查新加入的 AComponent 的名称由空字符串改为新的名称是否有效；
• 在 RemoveComponent 的时候，使用 ValidateRename 方法检查移除的 AComponent 的名字改为空字符串是否有效；
• ValidateRename 检查 AComponent 在当前组件里面，在所有的子组件 (即 Components 属性) 里面，是否有同名组件，并且检查在 Owner 里面是否有同名组件；
• ValidateRename 是组件内部调用的方法，不需要直接调用。

参考：

• System::Classes::TComponent::Name
• System::Classes::TComponent::SetName
• System::Classes::TComponent::ChangeName
• System::Classes::TComponent::InsertComponent
• System::Classes::TComponent::RemoveComponent
• System::Classes::TComponent::ValidateContainer
• System::Classes::TComponent::ValidateInsert
• System::Classes::TComponent
• System::Classes::TPersistent
• System::TObject
• VCL 类继承关系

C++ Builder 参考手册 ➙ TComponent ➙ ValidateRename