This topic covers the implementation details of TBoxTextAttr.
Scope: TypeDefinitions.pas; record. Prepared from the curated implementation supplied for this review on 2 October 2026.
Groups text-in-box changes including insets, columns, vertical alignment and first-baseline settings. This is selected by a macro box action distinct from ordinary token text-formatting actions. Each substructure’s Enabled/modification switch gates its payload.
Notation and shared helper rules: Reading this reference.
Literal rec_type values emitted within these routines: TBoxTextAttr. 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.
Columns/Enabled
XML representation: The text of the Enabled element.
Initial value: false (TBoxTextAttr.Initialize).
Reading: Reads the element into Columns.Enabled when the record node exists.
Writing: Stores true or false according to Columns.Enabled whenever the writer reaches this field.
Columns/Action
XML representation: The text of the Action element.
Initial value: cccSet (0) (TBoxTextAttr.Initialize).
Reading: Reads the element into Columns.Action when the record node exists; Columns.Enabled is true.
Writing: Stores the numeric value of Columns.Action (see the value table below) when Columns.Enabled is true.
Columns/Count
XML representation: The text of the Count element.
Initial value: 1 (TBoxTextAttr.Initialize).
Reading: Reads the element into Columns.Count when the record node exists; Columns.Enabled is true.
Writing: Stores the numeric value of Columns.Count when Columns.Enabled is true.
Columns/GutterEnabled
XML representation: The text of the GutterEnabled element.
Initial value: false (TBoxTextAttr.Initialize).
Reading: Reads the element into Columns.GutterEnabled when the record node exists; Columns.Enabled is true.
Writing: Stores true or false according to Columns.GutterEnabled when Columns.Enabled is true.
Columns/GutterWidth
XML representation: The text of the GutterWidth element.
Initial value: 0.0 (TBoxTextAttr.Initialize).
Reading: Reads the stored number, divides it by 1000000.0, and assigns the result to Columns.GutterWidth when the record node exists; Columns.Enabled is true. The temporary numeric value starts at 0 before reading.
Writing: Stores Columns.GutterWidth multiplied by 1000000, then rounded to an integer when Columns.Enabled is true.
Insets/Enabled
XML representation: The text of the Enabled element.
Initial value: false (TBoxTextAttr.Initialize).
Reading: Reads the element into Insets.Enabled when the record node exists.
Writing: Stores true or false according to Insets.Enabled whenever the writer reaches this field.
Insets/MultipleInsets
XML representation: The text of the MultipleInsets element.
Initial value: false (TBoxTextAttr.Initialize).
Reading: Reads the element into Insets.MultipleInsets when the record node exists; Insets.Enabled is true.
Writing: Stores true or false according to Insets.MultipleInsets when Insets.Enabled is true.
Insets/TopOrAllSides
XML representation: The text of the TopOrAllSides element.
Initial value: 0.0 (TBoxTextAttr.Initialize).
Reading: Reads the stored number, divides it by 1000000.0, and assigns the result to Insets.TopOrAllSides when the record node exists; Insets.Enabled is true. The temporary numeric value starts at 0 before reading.
Writing: Stores Insets.TopOrAllSides multiplied by 1000000, then rounded to an integer when Insets.Enabled is true.
Insets/Left
XML representation: The text of the Left element.
Initial value: 0.0 (TBoxTextAttr.Initialize).
Reading: Reads the stored number, divides it by 1000000.0, and assigns the result to Insets.Left when the record node exists; Insets.Enabled is true. The temporary numeric value starts at 0 before reading.
Writing: Stores Insets.Left multiplied by 1000000, then rounded to an integer when Insets.Enabled is true.
Insets/Bottom
XML representation: The text of the Bottom element.
Initial value: 0.0 (TBoxTextAttr.Initialize).
Reading: Reads the stored number, divides it by 1000000.0, and assigns the result to Insets.Bottom when the record node exists; Insets.Enabled is true. The temporary numeric value starts at 0 before reading.
Writing: Stores Insets.Bottom multiplied by 1000000, then rounded to an integer when Insets.Enabled is true.
Insets/Right
XML representation: The text of the Right element.
Initial value: 0.0 (TBoxTextAttr.Initialize).
Reading: Reads the stored number, divides it by 1000000.0, and assigns the result to Insets.Right when the record node exists; Insets.Enabled is true. The temporary numeric value starts at 0 before reading.
Writing: Stores Insets.Right multiplied by 1000000, then rounded to an integer when Insets.Enabled is true.
VertAlign/Enabled
XML representation: The text of the Enabled element.
Initial value: false (TBoxTextAttr.Initialize).
Reading: Reads the element into VertAlign.Enabled when the record node exists.
Writing: Stores true or false according to VertAlign.Enabled whenever the writer reaches this field.
VertAlign/Alignment
XML representation: The text of the Alignment element.
Initial value: vatTop (0) (TBoxTextAttr.Initialize).
Reading: Reads the element into VertAlign.Alignment when the record node exists; VertAlign.Enabled is true.
Writing: Stores the numeric value of VertAlign.Alignment (see the value table below) when VertAlign.Enabled is true.
VertAlign/InterParagMax
XML representation: The text of the InterParagMax element.
Initial value: 0.0 (TBoxTextAttr.Initialize).
Reading: Reads the stored number, divides it by 1000000.0, and assigns the result to VertAlign.InterParagMax when the record node exists; VertAlign.Enabled is true. The temporary numeric value starts at 0 before reading.
Writing: Stores VertAlign.InterParagMax multiplied by 1000000, then rounded to an integer when VertAlign.Enabled is true.
FirstBaseline/Enabled
XML representation: The text of the Enabled element.
Initial value: false (TBoxTextAttr.Initialize).
Reading: Reads the element into FirstBaseline.Enabled when the record node exists.
Writing: Stores true or false according to FirstBaseline.Enabled whenever the writer reaches this field.
FirstBaseline/Minimum
XML representation: The text of the Minimum element.
Initial value: fbAscent (2) (TBoxTextAttr.Initialize).
Reading: Reads the element into FirstBaseline.Minimum when the record node exists; FirstBaseline.Enabled is true.
Writing: Stores the numeric value of FirstBaseline.Minimum (see the value table below) when FirstBaseline.Enabled is true.
FirstBaseline/Offset
XML representation: The text of the Offset element.
Initial value: 0.0 (TBoxTextAttr.Initialize).
Reading: Reads the stored number, divides it by 1000000.0, and assigns the result to FirstBaseline.Offset when the record node exists; FirstBaseline.Enabled is true. The temporary numeric value starts at 0 before reading.
Writing: Stores FirstBaseline.Offset multiplied by 1000000, then rounded to an integer when FirstBaseline.Enabled is true.
@rec_type
XML representation: The rec_type attribute.
Writing: Stores the literal text “TBoxTextAttr” whenever the writer reaches this field.
Initialization and reset values
TBoxTextAttr.Initialize
Setting or temporary variable |
Initial value |
When it is assigned |
self |
Default (TBoxTextAttr) |
Always |
Columns.Enabled |
false |
Always |
Columns.Action |
cccSet (0) |
Always |
Columns.Count |
1 |
Always |
Columns.GutterEnabled |
false |
Always |
Columns.GutterWidth |
0.0 |
Always |
Insets.Enabled |
false |
Always |
Insets.MultipleInsets |
false |
Always |
Insets.TopOrAllSides |
0.0 |
Always |
Insets.Left |
0.0 |
Always |
Insets.Bottom |
0.0 |
Always |
Insets.Right |
0.0 |
Always |
VertAlign.Enabled |
false |
Always |
VertAlign.Alignment |
vatTop (0) |
Always |
VertAlign.InterParagMax |
0.0 |
Always |
FirstBaseline.Enabled |
false |
Always |
FirstBaseline.Minimum |
fbAscent (2) |
Always |
FirstBaseline.Offset |
0.0 |
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.
cvtAction
Ordinal |
Declared member |
0 |
cvaSubstituteRTF |
1 |
cvaStrReplace |
2 |
cvaChgColor |
3 |
cvaSetFrame |
4 |
cvaDelSingleTextBox |
5 |
cvaDelGroupTextBox |
6 |
cvaDelAllOnPageLayer |
7 |
cvaDelOutputPage |
8 |
cvaInsertImage |
9 |
cvaHighlightError |
10 |
cvaNeverDelete |
11 |
cvaBoxFit |
12 |
cvaBoxFitNEW |
13 |
cvaBoxBringToFront |
14 |
cvaBoxBringForward |
15 |
cvaBoxSendBackward |
16 |
cvaBoxSendToBack |
17 |
cvaVoluntaryQuarkCrash |
18 |
cvaDeleteCharsLeft |
19 |
cvaDeleteCharsRight |
20 |
cvaMoveToLayer |
21 |
cvaTextInBoxActionsMin |
22 |
cvatColCount |
23 |
cvatColGutter |
24 |
cvatInset |
25 |
cvatVAlign |
26 |
cvatBaseline |
27 |
cvaTextInBoxActionsMax |
28 |
cvaBoxActionsMin |
29 |
cvaSetBoxTOP |
30 |
cvaSetBoxBOTTOM |
31 |
cvaSetBoxHEIGHT |
32 |
cvaSetBoxLEFT |
33 |
cvaSetBoxRIGHT |
34 |
cvaSetBoxWIDTH |
35 |
cvaMoveBoxTOP |
36 |
cvaMoveBoxBOTTOM |
37 |
cvaMoveBoxLEFT |
38 |
cvaMoveBoxRIGHT |
39 |
cvaSetBoxHOR |
40 |
cvaSetBoxVERT |
41 |
cvaMoveBoxHOR |
42 |
cvaMoveBoxVERT |
43 |
cvaBoxActionsMax |
44 |
cvaBoxGrow |
45 |
cvaApplyStyleMin |
46 |
cvaApplyStyleChar |
47 |
cvaApplyStylePara |
48 |
cvaApplyStyleObj |
49 |
cvaApplyStyleCell |
50 |
cvaApplyStyleTable |
51 |
cvaApplyStyleMax |
TColCountAction
Ordinal |
Declared member |
0 |
cccSet |
1 |
cccIncrease |
2 |
cccDecrease |
TVertAlignType
Ordinal |
Declared member |
0 |
vatTop |
1 |
vatCentered |
2 |
vatBottom |
3 |
vatJustified |
TFirstBaselineType
Ordinal |
Declared member |
0 |
fbCapHeight |
1 |
fbCapAccent |
2 |
fbAscent |
TBoundingBox
Ordinal |
Declared member |
0 |
kPDFMediaBox |
1 |
kPDFCropBox |
2 |
kPDFBleedBox |
3 |
kPDFTrimBox |
4 |
kPDFVisibleContent |
5 |
kPDFArt |
6 |
kPDFPage |
7 |
kPDFContentAllLayers |
TCropOptions
Ordinal |
Declared member |
0 |
kINDDCropToPage |
1 |
kINDDCropToBleed |
2 |
kINDDCropToSlug |
TPictureBoxAlignment
Ordinal |
Declared member |
0 |
pbaCenterNoStretch |
1 |
pbaHomeoStretch |
2 |
pbaFullStretch |
3 |
pbaTopLeft |
4 |
pbaSpecificValues |
5 |
pbaScaleToFill |
6 |
pbaNone |
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 |
Insets |
TTextInsetsAttr |
member |
Columns |
TTextColumnsAttr |
member |
VertAlign |
TTextVertAlignAttr |
member |
FirstBaseline |
TFirstBaselineAttr |
member |
The Implementation toggle contains only TBoxTextAttr 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.