System.Classes.TWriter
Delphi
TWriter = class(TFiler)
C++
class PASCALIMPLEMENTATION TWriter : public TFiler
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| class | public | System.Classes.pas System.Classes.hpp |
System.Classes | System.Classes |
Description
TWriter is a specialized filer object that writes data to its associated stream.
TWriter is used internally by the component streaming system to write information associated with a component, such as published properties of components or custom property data, to a stream. TWriter handles the mechanics of writing the data associated with a component to a stream. It is the writer object, rather than the stream, that is responsible for handling the complexities of streaming components. These include methods for:
- Writing different kinds of items to the associated stream.
- Writing property deltas used for streaming inherited forms and properties with default values.
- Writing nested groups of items or collections to the stream.
Other methods and properties of TWriter are used for interacting with stream and component objects.
Do not directly create writer objects. Writers are automatically created in stream object methods or in global routines that initiate the streaming process. These include:
- The global routine ObjectTextToBinary procedure, which directly creates a writer.
- The global WriteComponentResFile function, which creates a file stream that creates a writer.
- The WriteDescendent method of TStream, which creates a writer object.
Once the streaming process is underway, programs do not need to directly manipulate writer objects. The interaction between the writer, component, and stream objects happens automatically in methods of these objects that make calls to each other.