Table of Contents

Field MaxMeasure

Namespace
DocWright.Core.Primitives
Assembly
DocWright.Core.dll

The largest magnitude, in twips, that a measure read out of a document may carry: 2^24 twips, or about 971 feet.

public const int MaxMeasure = 16777216

Returns

int
The largest magnitude, in twips, that a measure read out of a document may carry: 2^24 twips, or about 971 feet.

Remarks

Why a bound is needed at all. Layout arithmetic on this type is checked, which is correct — a silently wrapped length would be a wrong document rather than a rejected one. But the operands come from the file, and no file format bounds them: ECMA-376's ST_SignedTwipsMeasure is xsd:integer. So a single attribute set to 2147483647 makes the very first addition in the layout engine throw OverflowException, which is neither a document error a caller can act on nor a member of the library's exception taxonomy.

Why this particular value. It is derived, not fitted. Layout sums a bounded number of measures — a margin plus an indent plus a border plus a cell margin and so on — and 2^24 leaves 2^7 headroom before a sum of them can leave int. So any expression combining up to 127 clamped measures is representable by construction, which is what makes the checked operators safe rather than merely loud. It is also about 530 times the largest page Word supports (22 inches), so no real document can reach it and no measurement is being fitted to a corpus.

Readers clamp to this range at the parse boundary — the same thing Word does with its own narrower per-attribute limits — and do it silently, as Word does. This remark said until Phase 72 that they report a diagnostic; none ever did, and none was added then: ClampMeasure(long) has no diagnostics sink and is called from dozens of parse sites, and a value at this bound is some 530 of the largest pages tall, so a report would fire only on hostile input, where the clamp is the defence and the report would be noise.