System.Classes.TComponent.SetName

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure SetName(const NewName: TComponentName); virtual;

C++

virtual void __fastcall SetName(const TComponentName NewName);

Properties

Type Visibility Source Unit Parent
procedure
function
protected
System.Classes.pas
System.Classes.hpp
System.Classes TComponent

Description

Sets the value of the Name property.

SetName is the virtual property setter for the Name property. It calls the ChangeName method, which performs the actual name change.

ChangeName is not virtual; override SetName instead when modifying the behavior of the Name property.

Warning: Using SetName to change the name of a component at run time causes any references to the old name to become undefined. Any subsequent code that uses the old name will cause an exception.

See Also