RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TXMLDocument.NewInstance Method
TXMLDocument Class | TXMLDocument Members | XMLDoc Namespace | Description | See Also
Collapse All

Allocates memory for an instance of an object type and returns a pointer to that new instance.

Pascal
class function NewInstance: TObject; override;
C++
virtual __fastcall TObject * NewInstance();
Description

All constructors call System::TObject::NewInstance automatically. System::TObject::NewInstance calls System::TObject::InstanceSize to determine how much memory to allocate from the heap to contain a particular instance. Do not call System::TObject::NewInstance directly. 

Override System::TObject::NewInstance only for special memory allocation requirements. For example, when allocating a large number of identical objects that all need to be in memory at the same time, you could allocate a single block of memory for the entire group, then override System::TObject::NewInstance to use part of that larger block for each instance. 

If you override System::TObject::NewInstance to allocate memory, you may need to override System::TObject::FreeInstance to deallocate the memory.

Note: By default System::TObject::NewInstance calls System::TObject::InitInstance.
 

 

See Also
Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!