This topic covers the implementation details of TCombinedFrameShadeRec.
Scope: TypeDefinitions.pas; record. Prepared from the curated implementation supplied for this review on 2 October 2026.
ComboType selects None, Text, BoxCreate, BoxKeep, BoxModify or BoxDelete. It controls the meaning and presence of child shade/frame records. FWasReadIn is internal migration state, not a field to add to XML.
Older left/right encodings can be interpreted by UpdateFromLeftRightValues; its behavior is preserved in the supporting method details where supplied. Current-format editors should use the explicit ComboType form.
Notation and shared helper rules: Reading this reference.
Literal rec_type values emitted within these routines: TCombinedFrameShadeRec. Nested values may belong to child wrappers rather than this owner itself; the attribute entries below give their exact locations.
Exact XML fields and attributes
The paths below start at this record or property node. A slash identifies a child element; @ identifies an attribute. Curly braces mark a variable index or expression, not literal XML text. Initial values describe initialization; they do not establish what an omitted individual element does. The Implementation toggle below contains the supplied routines for exact branch order and conversions.
ComboType
XML representation: The text of the ComboType element.
Initial value: cfsNone (0) (TCombinedFrameShadeRec.Initialize).
Reading: Reads the element into buffInt when the record node exists. The subsequent conversion is shown in Implementation.
Writing: Stores the numeric value of ComboType (see the value table below) whenever the writer reaches this field.
DeleteOtherLayers
XML representation: The text of the DeleteOtherLayers element.
Initial value: false (TCombinedFrameShadeRec.Initialize).
Reading: Reads the element into DeleteOtherLayers when the record node exists; ComboType is not cfsNone (0).
Writing: Stores true or false according to DeleteOtherLayers when ComboType is not cfsNone (0).
Layer
XML representation: The text of the Layer element.
Initial value: 0 (TCombinedFrameShadeRec.Initialize).
Reading: Reads the element into Layer when the record node exists; ComboType is not cfsNone (0).
Writing: Stores the numeric value of Layer (see the value table below) when ComboType is not cfsNone (0).
@rec_type
XML representation: The rec_type attribute.
Writing: Stores the literal text “TCombinedFrameShadeRec” whenever the writer reaches this field.
Initialization and reset values
TCombinedFrameShadeRec.Initialize
Setting or temporary variable |
Initial value |
When it is assigned |
ComboType |
cfsNone (0) |
Always |
Layer |
0 |
Always |
DeleteOtherLayers |
false |
Always |
FWasReadIn |
false |
Always |
Value namespaces used by this implementation
These are declared Pascal ordinal values. Use the ordinal only where the field serializer actually writes ord(...), an integer cast or an equivalent value. Set-marker strings and local option lists have their own representation; sentinel members in an enum are not automatically legal XML choices.
TCombinedFrameShadeType
Ordinal |
Declared member |
0 |
cfsNone |
1 |
cfsText |
2 |
cfsBoxCreate |
3 |
cfsBoxKeep |
4 |
cfsBoxModify |
5 |
cfsBoxDelete |
Storage declarations relevant to interpretation
These are in-memory member and property types, not a list of mandatory XML children. They retain array bounds, fixed buffers and selector types. The field reference above defines what is actually serialized.
Name |
Declared type / bounds |
Kind |
ComboType |
TCombinedFrameShadeType |
member |
Layer |
integer |
member |
DeleteOtherLayers |
boolean |
member |
FWasReadIn |
boolean |
member |
The Implementation toggle contains only TCombinedFrameShadeRec methods. Initializers and helpers belonging to other types are identified separately below. Shared XML-helper limitations are explained in Reading this reference.
Declaration reproduces this record’s complete declaration from the supplied source, including its fields, properties and method signatures.