TComponentState set

Declaration

TComponentState= Set of (csLoading,csReading,csWriting,csDestroying,
 csDesigning,csAncestor,csUpdating,csFixups,
 csFreeNotification,csInline,csDesignInstance)

Description

The following values are possible:

csLoading

The component (and all child components) are being loaded from a stream. This means that a TReader instance is reading properties from this and child components from a stream and is applying the values found in the stream to the properties.

csReading

The properties of this component are being read from a stream. This means that a TReader instance is reading properties from this component from a stream and is applying the values.

csWriting

The properties of this component are being written to a stream. This means that a TWriter instance is writing properties from this component to a stream.

csDestroying

The component is being destroyed.

csDesigning

The component is being designed in an IDE.

csAncestor

The component has a design ancestor. This is used to record differences between a component and it's design ancestor. For example a form TForm2 inherited from a form TForm1. TForm1 and all its components are copied to TForm2. TForm2 and all its inherited components have csAncestor set. Only differences between TForm1 and TForm2 are stored in the stream of TForm2. The child components of a frame put onto a form have csAncestor too.

csInline

The component is a nested top level component. For example a frame on a form. The children of the frame do not have csInline, unless they are other frames.

csDesignInstance

The component is designed (csDesigning) and is a root component, meaning it has no owner (Owner=nil).

csFixups

The component's references to other components are being fixed. While reading a component from stream, it can happen that the stream contains a component reference property with a name of a component that was not yet created and read from the stream. Such properties are saved, and the missing references are resolved when the complete stream was read. This resolving step is called fixing up references, and the csFixups flags is set during this step.

csFreeNotification

This flag indicates that the component has free notifications registered with FreeNotification